Navigator
Navigator
インターフェイスは、ユーザーエージェントの状態や身元情報を表します。スクリプトからその情報を問い合わる、および活動を続けるためにそれら自体を登録することができます。
Navigator
オブジェクトは、読み取り専用の window.navigator
プロパティを使用して取得できます。
プロパティ
継承するプロパティはありませんが、 NavigatorID
, NavigatorLanguage
, NavigatorOnLine
, NavigatorContentUtils
, NavigatorStorage
, NavigatorStorageUtils
, NavigatorConcurrentHardware
, NavigatorPlugins
, NavigatorUserMedia
で定義されているプロパティを実装しています。
標準プロパティ
Navigator.connection
読取専用- デバイスのネットワーク状態の情報を提供する
NetworkInformation
オブジェクトを返します。 Navigator.cookieEnabled
読取専用- cookie へのセットが無視される場合 false、それ以外は true を返します。
Navigator.credentials
読取専用- ログインやログアウトの成功といったイベントが発生したときに資格情報を要求してユーザーエージェントへ通知する手段を提供する、
CredentialsContainer
(en-US) インターフェイスを返します。 Navigator.deviceMemory
読取専用- 端末のメモリーをギガバイト単位で返します。この値は 2 の階乗の最も近い値を 1024 で割った概算値です。
Navigator.doNotTrack
読取専用- ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
Navigator.geolocation
読取専用- デバイスの物理的な場所を取得することができる
Geolocation
オブジェクトを返します。 NavigatorConcurrentHardware.hardwareConcurrency
読取専用- 使用可能な論理プロセッサーコアの数を返します。
NavigatorPlugins.javaEnabled
読取専用- このブラウザーで Java が利用できるかどうかを
Boolean
で返します。 Navigator.keyboard
読取専用Keyboard
(en-US) オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。NavigatorLanguage.language
読取専用- ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の
DOMString
を返します。不明な場合にはnull
を返します。 NavigatorLanguage.languages
読取専用- ユーザーが知っている言語を表す
DOMString
を、望ましい順に並べた配列を返します。 Navigator.locks
読取専用- 新しい
Lock
(en-US) オブジェクトを要求したり、既存のLock
(en-US) オブジェクトをクエリしたりするためのLockManager
(en-US) オブジェクトを返します。 Navigator.maxTouchPoints
読取専用- 現在の端末で対応している同時タッチ点の最大数を返します。
Navigator.mediaCapabilities
読取専用- 指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる
MediaCapabilities
(en-US) オブジェクトを返します。 Navigator.mediaDevices
読取専用- 使用可能なメディアデバイスの情報を取得する (
MediaDevices.enumerateDevices()
)、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限できるかを確認する (MediaDevices.getSupportedConstraints()
)、MediaDevices.getUserMedia()
を使用してメディアへのアクセスを要求するといったことができる、MediaDevices
オブジェクトへの参照を返します。 Navigator.mediaSession
(en-US) 読取専用- Returns
MediaSession
object which can be used to provide metadata that can be used by the browser to present information about the currently-playing media to the user, such as in a global media controls UI. NavigatorPlugins.mimeTypes
読取専用- ブラウザーが対応している MIME タイプのリストを
MimeTypeArray
(en-US) で返します。 Navigator.onLine
(en-US) 読取専用- 現在のブラウザーがオンラインかどうかを示す
Boolean
を返します。 Navigator.permissions
読取専用- Permissions API が対応する API の許可状態の問い合わせや更新に使用できる、
Permissions
オブジェクトを返します。 NavigatorPlugins.plugins
読取専用- 現在のブラウザーにインストールされているプラグインをリストした
PluginArray
を返します。 Navigator.presentation
読取専用Presentation
(en-US) API への参照を返します。Navigator.serviceWorker
読取専用ServiceWorkerContainer
オブジェクトを返します。これは、associated document のServiceWorker
オブジェクトの登録、削除、更新、通信の機能を提供します。NavigatorStorage.storage
読取専用- サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトン
StorageManager
オブジェクトを返します。 NavigatorID.userAgent
読取専用- 現在のブラウザーのユーザーエージェントを表す文字列を返します。
Navigator.vendor
読取専用- 現在のブラウザーのベンダーネームを返します (例 "Netscape6")。
Navigator.webdriver
読取専用- ユーザーエージェントが自動で制御されているかどうかを示します。
Navigator.xr
読取専用- Returns
XR
(en-US) object, which represents the entry point into the WebXR API.
標準外プロパティ
Navigator.buildID
- ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では
20181001000000
となります。 Navigator.securitypolicy
- 空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。
Navigator.standalone
- ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。
Navigator.wakeLock
(en-US) 読取専用- Returns a
WakeLock
(en-US) interface you can use to request screen wake locks and prevent screen from dimming, turning off, or showing a screen saver.
非推奨のプロパティ
NavigatorID.appCodeName
読取専用- 現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.appName
読取専用- このブラウザーの公式な名前の
DOMString
を返します。このプロパティが正確な値を返すことを期待しないで下さい。 NavigatorID.appVersion
読取専用- ブラウザーのバージョンを
DOMString
で返します。このプロパティが正確な値を返すことを期待しないで下さい。 Navigator.activeVRDisplays
読取専用- 現在表示中 (
VRDisplay.ispresenting
がtrue
) である、すべてのVRDisplay
オブジェクトを収めた配列を返します。 Navigator.battery
読取専用- バッテリー残量などの情報を取得できる
BatteryManager
(en-US) オブジェクトを返します。 Navigator.oscpu
読取専用- 現在の OS を表す文字列を返します。
NavigatorID.platform
読取専用- 現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.product
読取専用- どのブラウザーも、常に
'Gecko'
を返します。このプロパティは、互換性のために限って維持されています。 Navigator.productSub
読取専用- ブラウザーのビルド番号を返します (例, "20060909")。
Navigator.storageQuota
読取専用- 記憶域の使用量やクォータ情報の問い合わせや要求の手段を提供する、
StorageQuota
(en-US) インターフェイスを返します。 Navigator.vendorSub
読取専用- vendor version number を返します (例 "6.1").
メソッド
継承するメソッドはありませんが、 NavigatorID
, NavigatorContentUtils
, NavigatorUserMedia
, NavigatorStorageUtils
で定義されているメソッドを継承します。
Navigator.canShare()
(en-US)- Returns
true
if a call toNavigator.share()
would succeed. Navigator.registerProtocolHandler()
- 自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
Navigator.requestMediaKeySystemAccess()
(en-US)- MediaKeySystemAccess オブジェクト用の
Promise
を返します。 Navigator.sendBeacon()
- ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
Navigator.share()
- 現在のプラットフォームのネイティブ共有メカニズムを実行します。
Navigator.vibrate()
- バイブレーションがサポートされている場合、デバイスにバイブレーションを起こします。サポートされていない場合、何もしません。
非推奨のメソッド
Navigator.getVRDisplays()
- コンピューターに接続されて使用可能な VR デバイスを表す
VRDisplay
の配列に解決される promise を返します。 Navigator.getUserMedia()
- ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの audio または video ストリームを返します。
Navigator.registerContentHandler()
- ウェブサイトが自分自身を、ある MIME タイプのハンドラーとして登録できるようにします。
NavigatorID.taintEnabled()
(en-US)false
を返します。JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
HTML Living Standard the Navigator object の定義 |
現行の標準 |
ブラウザーの互換性
BCD tables only load in the browser