Navigator

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

Navigator 介面表示使用者代理的狀態和身份。它允許指令碼查詢自身並註冊以執行某些活動。

可以使用只讀的 window.navigator 屬性檢索 Navigator 物件。

例項屬性

不繼承任何屬性。

標準屬性

返回當前文件的 Bluetooth 物件,提供對 Web Bluetooth API 功能的訪問。

返回一個 Clipboard 物件,該物件提供對系統剪貼簿的讀寫訪問。

返回一個 NetworkInformation 物件,其中包含有關裝置網路連線的資訊。

返回一個 ContactsManager 介面,允許使用者從其聯絡人列表中選擇條目,並將所選條目的有限詳細資訊與網站或應用程式共享。

如果設定 Cookie 將被忽略,則返回 false;否則返回 true。

返回 CredentialsContainer 介面,該介面公開了請求憑據和在發生有趣事件(例如成功登入或登出)時通知使用者代理的方法。

返回以千兆位元組為單位的裝置記憶體量。此值是透過四捨五入到最接近的 2 的冪並將該數字除以 1024 得到的近似值。

返回瀏覽器的 DevicePosture 物件,它允許開發者查詢裝置的當前姿態(即視口是處於平面狀態還是摺疊狀態),並根據姿態變化執行程式碼。

返回一個 Geolocation 物件,允許訪問裝置的位置。

返回當前瀏覽上下文的 GPU 物件。WebGPU API 的入口點。

返回可用邏輯處理器核心的數量。

返回一個 HID 物件,提供連線 HID 裝置、列出已連線 HID 裝置以及連線 HID 裝置的事件處理程式的方法。

返回當前文件的 Ink 物件,提供對 Ink API 功能的訪問。

返回一個 Keyboard 物件,該物件提供訪問函式,這些函式用於檢索鍵盤佈局對映並切換從物理鍵盤捕獲按鍵。

返回一個字串,表示使用者的首選語言,通常是瀏覽器 UI 的語言。當未知時,返回 null 值。

返回一個字串陣列,按優先順序順序表示使用者已知的所有語言。

返回一個 LockManager 物件,該物件提供請求新 Lock 物件和查詢現有 Lock 物件的方法。

提供對瀏覽器 NavigatorLogin 物件的訪問,聯合身份提供商 (IdP) 可以使用該物件在使用者登入或登出 IdP 時設定使用者的登入狀態。有關更多詳細資訊,請參閱 聯合憑證管理 (FedCM) API

返回當前裝置支援的最大同時觸控接觸點數。

返回一個 MediaCapabilities 物件,該物件可以公開有關給定格式的解碼和編碼功能以及輸出功能的資訊。

返回一個 MediaDevices 物件的引用,然後可以使用該物件獲取有關可用媒體裝置的資訊 (MediaDevices.enumerateDevices()),瞭解使用者的計算機和使用者代理支援哪些可約束媒體屬性 (MediaDevices.getSupportedConstraints()),以及使用 MediaDevices.getUserMedia() 請求訪問媒體。

返回 MediaSession 物件,該物件可用於提供元資料,瀏覽器可以使用這些元資料向用戶呈現有關當前播放媒體的資訊,例如在全域性媒體控制元件 UI 中。

返回一個布林值,指示瀏覽器是否線上工作。

如果瀏覽器可以在導航到 PDF 檔案時以內聯方式顯示 PDF 檔案,則返回 true;否則返回 false

返回一個 Permissions 物件,該物件可用於查詢和更新 Permissions API 涵蓋的 API 的許可權狀態。

返回對 Presentation API 的引用。

返回當前文件的 Scheduling 物件。

返回一個 Serial 物件,該物件表示 Web Serial API 的入口點,以實現對序列埠的控制。

返回一個 ServiceWorkerContainer 物件,該物件提供訪問與關聯文件ServiceWorker 物件的註冊、刪除、升級和通訊。

返回用於管理永續性許可權並按站點/應用程式估算可用儲存空間的單例 StorageManager 物件。

返回當前文件的 USB 物件,提供對 WebUSB API 功能的訪問。

返回一個 UserActivation 物件,其中包含有關當前視窗使用者啟用狀態的資訊。

返回當前瀏覽器的使用者代理字串。

返回一個 NavigatorUAData 物件,該物件提供對使用者瀏覽器和作業系統資訊的訪問。

返回對 VirtualKeyboard API 的引用,以控制螢幕上的虛擬鍵盤。

返回一個 WakeLock 介面,可用於請求螢幕喚醒鎖,並防止螢幕變暗、關閉或顯示螢幕保護程式。

指示使用者代理是否由自動化控制。

返回 WindowControlsOverlay 介面,該介面公開了桌面漸進式 Web 應用程式中標題欄的幾何資訊,以及一個用於瞭解其何時更改的事件。

返回 XRSystem 物件,該物件表示 WebXR API 的入口點。

非標準屬性

返回瀏覽器的構建識別符號。在現代瀏覽器中,此屬性現在返回固定的時間戳作為隱私措施,例如,Firefox 64 及更高版本中的 20181001000000

返回一個布林值,指示使用者是否同意共享或出售其資訊。

返回一個布林值,指示瀏覽器是否以獨立模式執行。僅適用於 Apple 的 iOS Safari。

已廢棄的屬性

返回一個數組,其中包含當前正在呈現的每個 VRDisplay 物件(VRDisplay.isPresentingtrue)。

在任何瀏覽器中始終返回 'Mozilla'

在任何瀏覽器中始終返回 'Netscape'

以字串形式返回瀏覽器版本。請勿依賴此屬性返回正確的值。

報告使用者的“不跟蹤”偏好設定的值。當此值為“1”時,您的網站或應用程式不應跟蹤使用者。

返回一個 MimeTypeArray,列出瀏覽器支援的 MIME 型別。

返回一個表示當前作業系統的字串。

返回一個表示瀏覽器平臺的字串。請勿依賴此函式返回有意義的值。

返回一個 PluginArray,列出瀏覽器中安裝的外掛。

在任何瀏覽器中始終返回 'Gecko'

返回字串 '20030107''"20100101'

返回空字串、'Apple Computer Inc.''Google Inc.'

始終返回空字串。

例項方法

不繼承任何方法。

如果呼叫 Navigator.share() 將成功,則返回 true

清除當前應用程式圖示上的徽章,並返回一個解析為 undefinedPromise

替換給定不透明 URN 或 FencedFrameConfig 內部 url 屬性對應的對映 URL 中指定的字串。此方法已作為臨時措施(因此“已棄用”)提供,以啟用圍欄框架 URL 的替換,幫助廣告技術提供商將其現有實現遷移到 隱私沙盒 API。

返回一個值,指示是否允許指定媒體元素、音訊上下文或媒體功能“型別”自動播放。

返回一個 Promise,該 Promise 解析為一個 BatteryManager 物件,該物件返回有關電池充電狀態的資訊。

返回一個 Gamepad 物件陣列,每個連線到裝置的 Gamepad 對應一個。

返回一個 Promise,該 Promise 解析為一個物件陣列,表示使用者已安裝的任何相關的原生應用程式或 漸進式 Web 應用程式

允許網站將自己註冊為給定協議的可能處理程式。

返回一個 Promise,用於 MediaKeySystemAccess 物件。

返回一個 Promise,表示請求訪問使用者系統上的 MIDI 裝置。

用於使用 HTTP 從使用者代理非同步傳輸少量資料到 Web 伺服器。

在此應用程式關聯的圖示上設定徽章,並返回一個解析為 undefinedPromise

呼叫當前平臺的原生共享機制。

使支援振動的裝置振動。如果不支援振動,則不執行任何操作。

登出作為給定協議處理程式的網站。

已廢棄的方法

在提示使用者許可後,返回與本地計算機上的攝像頭或麥克風關聯的音訊或影片流。

返回一個 Promise,該 Promise 解析為一個 VRDisplay 物件陣列,表示連線到計算機的任何可用 VR 裝置。

始終返回 false。

返回 false。JavaScript taint/untaint 函式在 JavaScript 1.2 中已刪除。

規範

規範
HTML
# the-navigator-object

瀏覽器相容性