CARVIEW |
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
Navigator
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
Navigator
インターフェイスは、ユーザーエージェントの状態や身元情報を表します。これにより、スクリプトがこれらの問い合わせを行ったり、アクティビティを実行するために自分自身を登録したりすることができます。
Navigator
オブジェクトは、読み取り専用の window.navigator
プロパティを使用して取得できます。
インスタンスプロパティ
継承しているプロパティはありません。
標準プロパティ
Navigator.bluetooth
読取専用 Experimental 安全なコンテキスト用-
現在の文書の
Bluetooth
オブジェクトを返し、 Web Bluetooth API の機能へのアクセスを提供します。 Navigator.clipboard
読取専用 安全なコンテキスト用-
Clipboard
オブジェクトを返し、システムクリップボードへの読み書きアクセスを提供します。 Navigator.connection
読取専用-
端末のネットワーク状態の情報を含む
NetworkInformation
オブジェクトを返します。 Navigator.contacts
読取専用 Experimental 安全なコンテキスト用-
ContactsManager
インターフェイスを返します。これにより、ユーザーが連絡先リストから項目を選択したり、選択した項目の制限付きの詳細をウェブサイトやアプリケーションと共有したりすることができます。 Navigator.cookieEnabled
読取専用-
Cookie への設定を無視する場合は false、それ以外は true を返します。
Navigator.credentials
読取専用 安全なコンテキスト用-
CredentialsContainer
インターフェイスを返し、ログインやログアウトの成功といったイベントが発生したときに、資格情報を要求してユーザーエージェントへ通知する手段を提供します。 Navigator.deviceMemory
読取専用 Experimental-
端末のメモリーをギガバイト単位で返します。この値は 2 の累乗に最も近い値を 1024 で割った概算値です。
Navigator.geolocation
読取専用-
端末の物理的な場所を取得することができる
Geolocation
オブジェクトを返します。 Navigator.gpu
読取専用 Experimental 安全なコンテキスト用-
現在の閲覧コンテキストの
GPU
オブジェクトを返します。 WebGPU API のエントリーポイントです。 Navigator.hardwareConcurrency
読取専用-
使用可能な論理プロセッサーのコア数を返します。
Navigator.hid
読取専用 Experimental 安全なコンテキスト用-
HID
オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。 Navigator.ink
読取専用 ExperimentalNavigator.keyboard
読取専用 Experimental 安全なコンテキスト用-
Keyboard
オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。 Navigator.language
読取専用-
ユーザーにとって一番望ましい言語(たいていはブラウザー UI の言語)の文字列を返します。不明な場合には
null
を返します。 Navigator.languages
読取専用-
ユーザーが知っている言語を表す文字列を、望ましい順に並べた配列を返します。
Navigator.locks
読取専用 安全なコンテキスト用-
LockManager
オブジェクトを返します。これは、新しいLock
オブジェクトを要求したり、既存のLock
オブジェクトをクエリーしたりするためのものです。 Navigator.login
読取専用 Experimental 安全なコンテキスト用-
ブラウザーの
NavigatorLogin
オブジェクトへのアクセスを提供します。これは、連合 ID プロバイダー (IdP) が、ユーザーが IdP にログインまたはログインする際に、ユーザーのログインステータスを設定するために使用することができます。詳細は、連合資格情報管理 (FedCM) API を参照してください。 Navigator.maxTouchPoints
読取専用-
現在の端末で対応している同時タッチ点の最大数を返します。
Navigator.mediaCapabilities
読取専用-
指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる
MediaCapabilities
オブジェクトを返します。 Navigator.mediaDevices
読取専用 安全なコンテキスト用-
MediaDevices
オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する (MediaDevices.enumerateDevices()
)、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限することができるかを確認する (MediaDevices.getSupportedConstraints()
)、MediaDevices.getUserMedia()
を使用してメディアへのアクセスを要求するといったことができます。 Navigator.mediaSession
読取専用-
MediaSession
オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。 Navigator.onLine
読取専用-
現在のブラウザーがオンラインかどうかを示す論理値を返します。
Navigator.pdfViewerEnabled
読取専用-
ブラウザーが PDF に移動したときにインラインで表示できるのであれば
true
を、そうでなければfalse
を返します。 Navigator.permissions
読取専用-
Permissions
オブジェクトを返します。これは、権限 API が対応する API の許可状態の問い合わせや更新に使用できます。 Navigator.presentation
読取専用 安全なコンテキスト用-
Presentation
API への参照を返します。 Navigator.scheduling
読取専用 Experimental-
現在の文書の
Scheduling
オブジェクトを返します。 Navigator.serial
読取専用 Experimental 安全なコンテキスト用-
Serial
オブジェクトを返します。これは、シリアルポートを制御できるようにするウェブシリアル API のエントリーポイントを表します。 Navigator.serviceWorker
読取専用 安全なコンテキスト用-
ServiceWorkerContainer
オブジェクトを返します。これは、関連付けれた文書のServiceWorker
オブジェクトの登録、削除、更新、通信の機能を提供します。 Navigator.storage
読取専用 安全なコンテキスト用-
サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの
StorageManager
オブジェクトを返します。 Navigator.usb
読取専用 安全なコンテキスト用-
現在の文書内の
USB
オブジェクトを返します。WebUSB API の機能へのアクセスを提供します。 Navigator.userActivation
読取専用-
現在のウィンドウのユーザー起動状態に関する情報を格納した
UserActivation
オブジェクトを返します。 Navigator.userAgent
読取専用-
現在のブラウザーのユーザーエージェントを表す文字列を返します。
Navigator.userAgentData
読取専用 Experimental 安全なコンテキスト用-
ユーザーのブラウザーとオペレーティングシステムに関する情報にアクセスするための
NavigatorUAData
オブジェクトを返します。 Navigator.virtualKeyboard
読取専用 Experimental 安全なコンテキスト用-
画面上の仮想キーボードを制御するための
VirtualKeyboard
API への参照を返します。 Navigator.wakeLock
読取専用 安全なコンテキスト用-
WakeLock
インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。 Navigator.webdriver
読取専用-
ユーザーエージェントが自動で制御されているかどうかを示します。
Navigator.windowControlsOverlay
読取専用 安全なコンテキスト用-
WindowControlsOverlay
インターフェイスを返します。これは、デスクトップのプログレッシブウェブアプリにおける、タイトルバーの形状に関する情報と、それが変更されるたびに知るためのイベントを公開します。 Navigator.xr
読取専用 Experimental 安全なコンテキスト用
標準外のプロパティ
Navigator.buildID
読取専用 非標準-
ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では
20181001000000
となります。 Navigator.globalPrivacyControl
読取専用 Experimental 非標準-
ユーザーの情報が共有または販売されることへの同意を示す論理値を返します。
Navigator.standalone
非標準-
ブラウザーをスタンドアロンモードで実行しているかを示す論理値を返します。 Apple の iOS Safari だけで使用できます。
非推奨のプロパティ
Navigator.activeVRDisplays
読取専用 非推奨; 非標準-
VRDisplay
オブジェクトのうち、現在表示している(VRDisplay.ispresenting
がtrue
である)ものすべてを格納する配列を返します。 Navigator.appCodeName
読取専用 非推奨;-
どのブラウザーでも
'Mozilla'
を返します。 Navigator.appName
読取専用 非推奨;-
どのブラウザーでも
'Netscape'
を返します。 Navigator.appVersion
読取専用 非推奨;-
ブラウザーのバージョンを文字列で返します。このプロパティが正確な値を返すことを期待しないで下さい。
Navigator.doNotTrack
読取専用 非推奨; 非標準-
ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
Navigator.mimeTypes
読取専用 非推奨;-
ブラウザーが対応している MIME タイプの一覧を
MimeTypeArray
で返します。 Navigator.oscpu
読取専用 非推奨;-
現在の OS を表す文字列を返します。
Navigator.platform
読取専用 非推奨;-
現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
Navigator.plugins
読取専用 非推奨;-
PluginArray
を返します。これはブラウザーにインストールされているプラグインを列挙します。 Navigator.product
読取専用 非推奨;-
どのブラウザーも、常に
'Gecko'
を返します。 Navigator.productSub
読取専用 非推奨;-
'20030107'
または'"20100101'
の文字列のどちらかを返します。 Navigator.vendor
読取専用 非推奨;-
空文字列、
'Apple Computer Inc.'
、'Google Inc.'
のいずれかを返します。 Navigator.vendorSub
読取専用 非推奨;-
常に空文字列を返します。
インスタンスメソッド
継承するメソッドはありません。
Navigator.canShare()
安全なコンテキスト用-
Navigator.share()
の呼び出しが成功した場合はtrue
を返します。 Navigator.clearAppBadge()
安全なコンテキスト用Navigator.deprecatedReplaceInURN()
Experimental-
指定された文字列は、指定された不透明な URN または
FencedFrameConfig
内部のurl
プロパティに対応する URL で置換されます。このメソッドは、一時的な措置として利用できるようになりました(そのため「非推奨」となっています)。フェンスで囲まれたフレームの URL で置換できるようにすることで、広告技術プロバイダーが既存の実装をプライバシーサンドボックス API に移行するのに役立つためです。 Navigator.getAutoplayPolicy()
Experimental-
指定したメディア要素、音声コンテキスト、またはメディア機能の "type" が自動再生を許可されているかどうかを示す値を返します。
Navigator.getBattery()
安全なコンテキスト用-
BatteryManager
オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。 Navigator.getGamepads()
-
Gamepad
オブジェクトの配列を返します。それぞれがこの端末に接続されているゲームパッドを表します。 Navigator.getInstalledRelatedApps()
Experimental 安全なコンテキスト用-
ユーザーがインストールしている、関連するネイティブまたはプログレッシブウェブアプリを表すオブジェクトの配列で解決するプロミスを返します。
Navigator.registerProtocolHandler()
安全なコンテキスト用-
自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
Navigator.requestMediaKeySystemAccess()
安全なコンテキスト用-
MediaKeySystemAccess オブジェクト用の
Promise
を返します。 Navigator.requestMIDIAccess()
安全なコンテキスト用-
ユーザーのシステムにおいて MIDI 機器にアクセスするリクエストを表す
Promise
を返します。 Navigator.sendBeacon()
-
ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
Navigator.setAppBadge()
安全なコンテキスト用Navigator.share()
安全なコンテキスト用-
現在のプラットフォームのネイティブ共有メカニズムを実行します。
Navigator.vibrate()
-
バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。
Navigator.unregisterProtocolHandler()
安全なコンテキスト用-
指定されたプロトコルのハンドラーであるウェブサイトの登録を解除します。
非推奨のメソッド
Navigator.getUserMedia()
非推奨; 安全なコンテキスト用-
ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。
Navigator.getVRDisplays()
非推奨; 非標準-
コンピューターに接続されて使用可能な VR 機器を表す
VRDisplay
の配列に解決されるプロミスを返します。 Navigator.javaEnabled()
非推奨;-
常に false を返します。
Navigator.taintEnabled()
非推奨;-
false
を返します。 JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。
仕様書
Specification |
---|
HTML> # the-navigator-object> |
ブラウザーの互換性
Loading…