Navigator

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Navigator 인터페이스는 사용자 에이전트의 상태와 신원 정보를 나타내며, 스크립트로 해당 정보를 질의할 때와 애플리케이션을 특정 활동에 등록할 때 사용합니다.

Navigator 객체는 window.navigator 읽기 전용 속성으로 접근할 수 있습니다.

속성

아무 속성도 상속하지 않습니다.

표준 속성

현재 문서의 Bluetooth 객체를 반환합니다. Web Bluetooth API의 기능에 접근할 수 있습니다.

시스템 클립보드의 읽기, 쓰기에 접근할 수 있는 Clipboard 객체를 반환합니다.

장치의 네트워크 연결 정보를 담은 NetworkInformation 객체를 반환합니다.

사용자에게 사용자의 연락처 목록에서 항목을 선택하고 그 항목의 제한된 세부 정보를 웹사이트나 애플리케이션과 공유할 수 있게 하는 ContactsManager 인터페이스를 반환합니다.

쿠키 설정을 할 수 있으면 참, 아니면 거짓을 반환합니다.

CredentialsContainer 인터페이스를 반환합니다. 사용자 인증 정보를 요청하거나, 로그인 및 로그아웃 등 중요한 인증 관련 이벤트가 발생한 것을 사용자 에이전트에게 알려줄 때 사용합니다.

장치의 메모리를 기가바이트 단위로 반환합니다. 근삿값으로, 실제 값을 가장 가까운 2의 배수로 반올림한 후에 1024로 나눠서 제공합니다.

장치의 위치 정보에 접근할 수 있는 Geolocation 객체를 반환합니다.

현재 브라우징 맥략의 GPU 객체를 반환합니다. WebGPU API의 진입점입니다.

중앙처리장치의 사용 가능한 논리 코어 수를 반환합니다.

HID 객체를 반환합니다. HID 장치에 연결하고, 연결된 HID 장치를 나열하고, HID 장치에 대한 이벤트 처리기를 부착할 수 있습니다.

현재 문서의 Ink 객체를 반환합니다. Ink API의 기능에 접근할 수 있습니다.

Keyboard 객체를 반환합니다. 키보드 레이아웃 맵을 가져올 수 있고, 물리적 키보드의 키 입력 캡처를 켜고 끌 수 있습니다.

사용자의 선호 언어(주로 브라우저 UI 언어)를 나타내는 DOMString을 반환합니다. 언어를 알 수 없는 경우 null을 반환합니다.

사용자에게 알려진 언어 목록을 나타내는 DOMString 배열을 반환합니다. 정렬 순서는 사용자의 언어 선호도입니다.

새로운 Lock 객체를 요청하거나, 기존 Lock 객체를 질의할 수 있는 LockManager 객체를 반환합니다.

현재 장치에서 지원하는 최대 동시 터치 지점의 수를 반환합니다.

주어진 형식과 출력 형태에 대한 인코딩 및 디코딩 능력을 알아낼 수 있는 MediaCapabilities 객체를 반환합니다.

MediaStream 객체를 반환합니다. 사용 가능한 미디어 장치들의 정보를 가져오고(MediaDevices.enumerateDevices()), 사용자의 컴퓨터와 사용자 에이전트가 지원하는 미디어 제약 조건 속성을 알아내고(MediaDevices.getSupportedConstraints()), 미디어 접근을 요청할 수 있습니다(MediaDevices.getUserMedia()).

현재 재생 중인 미디어에 대한 메타데이터를 브라우저에게 제공할 때 사용하는 MediaSession 객체를 반환합니다. 브라우저는 이 데이터를 전역 미디어 컨트롤 UI 등에 표시할 수 있습니다.

브라우저가 온라인 상태인지 나타내는 불리언 값을 반환합니다.

브라우저가 PDF 파일을 탐색할 때 인라인으로 표시할 수 있으면 true, 그렇지 않으면 false를 반환합니다.

Permissions 객체를 반환합니다. Permissions API의 권한을 질의하고 상태를 변경할 수 있습니다.

Presentation API 참조를 반환합니다.

Serial 객체를 반환합니다. 직렬 포트를 제어할 수 있는 Web Serial API의 진입점입니다.

ServiceWorkerContainer 객체를 반환합니다. 연관 문서(associated document)ServiceWorker에 대한 등록, 제거, 업그레이드, 통신 기능을 제공합니다.

StorageManager 싱글턴 객체를 반환합니다. 사이트/앱에 할당된 저장 공간 권한을 관리하고, 남은 공간을 계산할 때 사용합니다.

현재 문서의 USB 객체를 반환합니다. WebUSB API의 기능에 접근할 수 있습니다.

현재 창의 사용자 활성화 상태에 대한 정보가 포함된 UserActivation 객체를 반환합니다.

현재 브라우저의 사용자 에이전트 문자열을 반환합니다.

NavigatorUAData 객체를 반환합니다. 사용자의 브라우저와 운영체제에 대한 정보를 제공합니다.

화면에 보이는 가상 키보드를 제어하기 위해 VirtualKeyboard API의 참조를 반환합니다.

WakeLock 인터페이스를 반환합니다. 화면 깨우기를 잠그도록 요청하거나, 화면을 어둡게 하기, 끄기, 화면 보호기 표시하기를 방지할 수 있도록 요청할 수 있습니다.

사용자 에이전트가 자동화에 의해 제어 중인지 나타냅니다.

WindowControlsOverlay 객체를 반환합니다. 데스크톱 PWA 제목표시줄의 형태에 대한 정보를 제공하고, 형태가 변화하는 것을 감지할 수 있는 이벤트도 발송합니다.

WebXR API의 진입점인 XR 객체를 반환합니다.

비표준 속성

브라우저의 빌드 식별자를 리턴합니다. 현재 최신 브라우저에서 이 속성은 개인 정보 보호 조치로 고정된 타임스탬프를 리턴합니다. 예를 들어 Firefox 64 이상에서는 20181001000000을 반환합니다.

자신의 정보가 공유되거나 판매되는 것에 대한 사용자의 동의를 나타내는 불리언 값을 리턴합니다.

브라우저가 독립 실행 모드로 실행중인지를 나타내는 불리언 값을 리턴합니다. Apple의 iOS Safari에서만 지원합니다.

사용되지 않는 속성

현재 VRDisplay.ispresentingtrue인 모든 VRDisplay 객체를 담고 있는 배열을 반환합니다.

어느 브라우저에서든 항상 'Mozilla'를 반환합니다.

어느 브라우저에서든 항상 'Netscape'를 반환합니다.

브라우저의 버전을 문자열로 반환합니다. 정확한 값으로 사용할 때에는 이 기능에 의존하지 마십시오.

사용자의 추적 금지 설정 값을 알립니다. 이 값이 "1"인 경우, 당신의 웹사이트 또는 애플리케이션은 사용자를 추적해서는 안됩니다.

브라우저가 지원하는 MIME 타입들을 나열하는 MimeTypeArray를 반환합니다.

현재 운영 체제를 나타내는 문자열을 반환합니다.

브라우저의 플랫폼을 나타내는 문자열을 반환합니다. 중요한 값으로 사용할 때에는 이 기능에 의존하지 마십시오.

브라우저에 설치된 플러그인을 나열하는 PluginArray을 반환합니다.

어느 브라우저에서든 항상 'Gecko'를 반환합니다.

'20030107''20100101' 중 하나를 문자열로 반환합니다.

빈 문자열, 'Apple Computer Inc.', 'Google Inc.' 중 하나를 반환합니다.

항상 빈 문자열을 반환합니다.

메서드

아무 메서드도 상속하지 않습니다.

Navigator.share() 호출이 성공할지 나타내는 불리언 값을 반환합니다.

현재 앱 아이콘의 배지를 제거하고, undefined로 이행하는 Promise를 반환합니다.

BatteryManager 객체로 이행하는 Promise를 반환합니다. BatteryManager는 전원 충전 상태 정보를 제공합니다.

주어진 프로토콜에 대해 현재 웹 사이트를 사용 가능한 처리기로 등록합니다.

MediaKeySystemAccess 객체로 이행하는 Promise를 반환합니다.

작은 데이터를 사용자 에이전트에서 웹 서버로, HTTP를 통해 비동기적으로 전송할 때 사용합니다.

현재 앱 아이콘에 배지를 추가하고, undefined로 이행하는 Promise를 반환합니다.

현재 플랫폼의 네이티브 공유 기능을 발동합니다.

지원하는 경우, 장치가 진동하도록 합니다. 진동을 지원하지 않는 장치에서는 아무것도 하지 않습니다.

사용되지 않는 메서드

사용자에게 권한을 요청한 후에 로컬 컴퓨터의 카메라 또는 마이크와 연관된 오디오나 비디오 스트림을 반환합니다.

VRDisplay 객체 배열을 이행하는 promise를 반환합니다. 이 객체는 컴퓨터에 사용 가능한 VR 기기가 연결되었는지를 나타냅니다.

항상 false를 반환합니다.

false를 반환합니다. JavaScript taint/untaint 기능은 JavaScript 1.2에서 제거되었습니다.

명세

Specification
HTML
# the-navigator-object

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
Navigator
activeVRDisplays
DeprecatedNon-standard
Secure context required
DeprecatedNon-standard
adAuctionComponents
Experimental
appCodeName
Deprecated
appName
Deprecated
appVersion
Deprecated
audioSession
Experimental
authentication
Experimental
bluetooth
Experimental
buildID
Non-standard
canLoadAdAuctionFencedFrame
Experimental
canShare
data.files parameter
data.text parameter
clearAppBadge
clearOriginJoinedAdInterestGroups
Experimental
clipboard
connection
contacts
Experimental
cookieEnabled
createAuctionNonce
Experimental
credentials
deprecatedReplaceInURN
Experimental
deprecatedRunAdAuctionEnforcesKAnonymity
Experimental
deviceMemory
devicePosture
Experimental
doNotTrack
DeprecatedNon-standard
geolocation
Secure context required
getAutoplayPolicy
Experimental
getBattery
Secure context required
Experimental
getGamepads
Secure context required
Experimental
getInstalledRelatedApps
Experimental
getInterestGroupAdAuctionData
Experimental
getUserMedia
Deprecated
getVRDisplays
DeprecatedNon-standard
globalPrivacyControl
Experimental
gpu
Experimental
hardwareConcurrency
hid
Experimental
ink
Experimental
javaEnabled
Deprecated
joinAdInterestGroup
Experimental
keyboard
Experimental
language
languages
leaveAdInterestGroup
Experimental
locks
login
Experimental
managed
Experimental
maxTouchPoints
mediaCapabilities
mediaDevices
Secure context required
mediaSession
mimeTypes
Deprecated
Returns MIME types from plugins rather than hard-coded PDF values
DeprecatedNon-standard
ml
Experimental
onLine
oscpu
Deprecated
pdfViewerEnabled
permissions
platform
Deprecated
plugins
Deprecated
Returns plugins rather than hard-coded PDF plugin values
DeprecatedNon-standard
presentation
product
Deprecated
productSub
Deprecated
protectedAudience
Experimental
registerProtocolHandler
scheme parameter supports bitcoin
scheme parameter supports cabal
ExperimentalNon-standard
scheme parameter supports dat
ExperimentalNon-standard
scheme parameter supports did
ExperimentalNon-standard
scheme parameter supports dweb
ExperimentalNon-standard
scheme parameter supports ethereum
ExperimentalNon-standard
scheme parameter supports ftp
Experimental
scheme parameter supports ftps
Experimental
scheme parameter supports geo
scheme parameter supports hyper
ExperimentalNon-standard
scheme parameter supports im
scheme parameter supports ipfs
ExperimentalNon-standard
scheme parameter supports ipns
ExperimentalNon-standard
scheme parameter supports irc
scheme parameter supports ircs
scheme parameter supports magnet
scheme parameter supports mailto
scheme parameter supports matrix
scheme parameter supports mms
scheme parameter supports news
scheme parameter supports nntp
scheme parameter supports openpgp4fpr
scheme parameter supports sftp
Experimental
scheme parameter supports sip
scheme parameter supports sms
scheme parameter supports smsto
scheme parameter supports ssb
ExperimentalNon-standard
scheme parameter supports ssh
scheme parameter supports tel
scheme parameter supports urn
scheme parameter supports webcal
scheme parameter supports wtai
scheme parameter supports xmpp
Secure context required
requestMIDIAccess
Secure context required
requestMediaKeySystemAccess
runAdAuction
Experimental
scheduling
Experimental
sendBeacon
serial
Experimental
serviceWorker
setAppBadge
share
data.files parameter
data.text parameter
storage
storageBuckets
Experimental
taintEnabled
Deprecated
unregisterProtocolHandler
updateAdInterestGroups
Experimental
usb
userActivation
userAgent
userAgentData
Experimental
Secure context required
Experimental
vendor
Deprecated
vendorSub
Deprecated
vibrate
virtualKeyboard
Experimental
wakeLock
webdriver
windowControlsOverlay
xr
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Requires a vendor prefix or different name for use.
Has more compatibility info.