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 インターフェイスを返します。これにより、ユーザーが連絡先リストから項目を選択したり、選択した項目の制限付きの詳細をウェブサイトやアプリケーションと共有したりすることができます。

Cookie への設定を無視する場合は false、それ以外は true を返します。

CredentialsContainer インターフェイスを返し、ログインやログアウトの成功といったイベントが発生したときに、資格情報を要求してユーザーエージェントへ通知する手段を提供します。

端末のメモリーをギガバイト単位で返します。この値は 2 の累乗に最も近い値を 1024 で割った概算値です。

端末の物理的な場所を取得することができる Geolocation オブジェクトを返します。

現在の閲覧コンテキストの GPU オブジェクトを返します。 WebGPU API のエントリーポイントです。

使用可能な論理プロセッサーのコア数を返します。

HID オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。

現在の文書の Ink オブジェクトを返し、 インク API の機能へのアクセスを提供します。

Keyboard オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。

ユーザーにとって一番望ましい言語(たいていはブラウザー UI の言語)の文字列を返します。不明な場合には null を返します。

ユーザーが知っている言語を表す文字列を、望ましい順に並べた配列を返します。

LockManager オブジェクトを返します。これは、新しい Lock オブジェクトを要求したり、既存の Lock オブジェクトをクエリーしたりするためのものです。

ブラウザーの NavigatorLogin オブジェクトへのアクセスを提供します。これは、連合 ID プロバイダー (IdP) が、ユーザーが IdP にログインまたはログインする際に、ユーザーのログインステータスを設定するために使用することができます。詳細は、連合資格情報管理 (FedCM) API を参照してください。

現在の端末で対応している同時タッチ点の最大数を返します。

指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる MediaCapabilities オブジェクトを返します。

MediaDevices オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する (MediaDevices.enumerateDevices())、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限することができるかを確認する (MediaDevices.getSupportedConstraints())、MediaDevices.getUserMedia() を使用してメディアへのアクセスを要求するといったことができます。

MediaSession オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。

現在のブラウザーがオンラインかどうかを示す論理値を返します。

ブラウザーが PDF に移動したときにインラインで表示できるのであれば true を、そうでなければ false を返します。

Permissions オブジェクトを返します。これは、権限 API が対応する API の許可状態の問い合わせや更新に使用できます。

Presentation API への参照を返します。

現在の文書の Scheduling オブジェクトを返します。

Serial オブジェクトを返します。これは、シリアルポートを制御できるようにするウェブシリアル API のエントリーポイントを表します。

ServiceWorkerContainer オブジェクトを返します。これは、関連付けれた文書ServiceWorker オブジェクトの登録、削除、更新、通信の機能を提供します。

サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの StorageManager オブジェクトを返します。

現在の文書内の USB オブジェクトを返します。WebUSB API の機能へのアクセスを提供します。

現在のウィンドウのユーザー起動状態に関する情報を格納した UserActivation オブジェクトを返します。

現在のブラウザーのユーザーエージェントを表す文字列を返します。

ユーザーのブラウザーとオペレーティングシステムに関する情報にアクセスするための NavigatorUAData オブジェクトを返します。

画面上の仮想キーボードを制御するための VirtualKeyboard API への参照を返します。

WakeLock インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。

ユーザーエージェントが自動で制御されているかどうかを示します。

WindowControlsOverlay インターフェイスを返します。これは、デスクトップのプログレッシブウェブアプリにおける、タイトルバーの形状に関する情報と、それが変更されるたびに知るためのイベントを公開します。

XRSystem オブジェクトを返します。これは WebXR API のエントリーポイントを表します。

標準外のプロパティ

ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では 20181001000000 となります。

ユーザーの情報が共有または販売されることへの同意を示す論理値を返します。

ブラウザーをスタンドアロンモードで実行しているかを示す論理値を返します。 Apple の iOS Safari だけで使用できます。

非推奨のプロパティ

VRDisplay オブジェクトのうち、現在表示している(VRDisplay.ispresentingtrue である)ものすべてを格納する配列を返します。

どのブラウザーでも 'Mozilla' を返します。

どのブラウザーでも 'Netscape' を返します。

ブラウザーのバージョンを文字列で返します。このプロパティが正確な値を返すことを期待しないで下さい。

ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。

ブラウザーが対応している MIME タイプの一覧を MimeTypeArray で返します。

現在の OS を表す文字列を返します。

現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。

PluginArray を返します。これはブラウザーにインストールされているプラグインを列挙します。

どのブラウザーも、常に 'Gecko' を返します。

'20030107' または '"20100101' の文字列のどちらかを返します。

空文字列、'Apple Computer Inc.''Google Inc.' のいずれかを返します。

常に空文字列を返します。

インスタンスメソッド

継承するメソッドはありません。

Navigator.share() の呼び出しが成功した場合は true を返します。

現在のアプリのバッジを消去し、 undefined に解決するプロミス (Promise) を返します。

指定された文字列は、指定された不透明な URN または FencedFrameConfig 内部の url プロパティに対応する URL で置換されます。このメソッドは、一時的な措置として利用できるようになりました(そのため「非推奨」となっています)。フェンスで囲まれたフレームの URL で置換できるようにすることで、広告技術プロバイダーが既存の実装をプライバシーサンドボックス API に移行するのに役立つためです。

指定したメディア要素、音声コンテキスト、またはメディア機能の "type" が自動再生を許可されているかどうかを示す値を返します。

BatteryManager オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。

Gamepad オブジェクトの配列を返します。それぞれがこの端末に接続されているゲームパッドを表します。

ユーザーがインストールしている、関連するネイティブまたはプログレッシブウェブアプリを表すオブジェクトの配列で解決するプロミスを返します。

自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。

MediaKeySystemAccess オブジェクト用の Promise を返します。

ユーザーのシステムにおいて MIDI 機器にアクセスするリクエストを表す Promise を返します。

ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。

このアプリに関連付けられたアイコンにバッジを設定し、 undefined で解決する Promise を返します。

現在のプラットフォームのネイティブ共有メカニズムを実行します。

バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。

指定されたプロトコルのハンドラーであるウェブサイトの登録を解除します。

非推奨のメソッド

ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。

コンピューターに接続されて使用可能な VR 機器を表す VRDisplay の配列に解決されるプロミスを返します。

常に 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.