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.

Das Navigator-Interface repräsentiert den Zustand und die Identität des Benutzeragenten. Es ermöglicht Skripten, diesen abzufragen und sich zu registrieren, um einige Aktivitäten fortzusetzen.

Ein Navigator-Objekt kann über die schreibgeschützte window.navigator-Eigenschaft abgerufen werden.

Instanz-Eigenschaften

Erbt keine Eigenschaften.

Standard-Eigenschaften

Gibt ein Bluetooth-Objekt für das aktuelle Dokument zurück, das Zugriff auf die Funktionalität der Web Bluetooth API bietet.

Gibt ein Clipboard-Objekt zurück, das Lese- und Schreibzugriff auf die Systemzwischenablage bietet.

Gibt ein NetworkInformation-Objekt zurück, das Informationen über die Netzwerkverbindung eines Geräts enthält.

Gibt eine ContactsManager-Schnittstelle zurück, die es den Benutzern ermöglicht, Einträge aus ihrer Kontaktliste auszuwählen und begrenzte Details der ausgewählten Einträge mit einer Website oder Anwendung zu teilen.

Gibt false zurück, wenn das Setzen eines Cookies ignoriert wird, und true andernfalls.

Gibt die CredentialsContainer-Schnittstelle zurück, die Methoden bereitstellt, um Anmeldeinformationen anzufordern und den Benutzeragenten über interessante Ereignisse wie erfolgreiche Anmeldungen oder Abmeldungen zu benachrichtigen.

Gibt die Menge des Gerätespeichers in Gigabyte zurück. Dieser Wert ist eine Annäherung, die durch Runden auf die nächste Potenz von 2 und Teilen dieser Zahl durch 1024 gegeben wird.

Gibt ein Geolocation-Objekt zurück, das den Zugriff auf den Standort des Geräts ermöglicht.

Gibt das GPU-Objekt für den aktuellen Browsing-Kontext zurück. Der Einstiegspunkt für die WebGPU API.

Gibt die Anzahl der verfügbaren logischen Prozessorkerne zurück.

Gibt ein HID-Objekt zurück, das Methoden zum Verbinden mit HID-Geräten, zum Auflisten angeschlossener HID-Geräte und Ereignishandler für angeschlossene HID-Geräte bereitstellt.

Gibt ein Ink-Objekt für das aktuelle Dokument zurück und ermöglicht den Zugriff auf die Funktionalität der Ink API.

Gibt ein Keyboard-Objekt zurück, das Zugriff auf Funktionen bietet, die Tastatur-Layout-Karten abrufen und das Erfassen von Tastenanschlägen von der physischen Tastatur umschalten.

Gibt eine Zeichenkette zurück, die die bevorzugte Sprache des Benutzers darstellt, normalerweise die Sprache der Browser-Oberfläche. Der Wert null wird zurückgegeben, wenn diese unbekannt ist.

Gibt ein Array von Zeichenketten zurück, die die dem Benutzer bekannten Sprachen in der Reihenfolge der Präferenz darstellen.

Gibt ein LockManager-Objekt zurück, das Methoden zum Anfordern eines neuen Lock-Objekts und zum Abfragen eines vorhandenen Lock-Objekts bereitstellt.

Bietet Zugriff auf das NavigatorLogin-Objekt des Browsers, das von einem föderierten Identitätsanbieter (IdP) verwendet werden kann, um den Anmeldestatus eines Benutzers zu setzen, wenn er sich beim IdP anmeldet oder abmeldet. Weitere Einzelheiten finden Sie in der Federated Credential Management (FedCM) API.

Gibt die maximale Anzahl gleichzeitiger Berührungspunkte zurück, die vom aktuellen Gerät unterstützt werden.

Gibt ein MediaCapabilities-Objekt zurück, das Informationen über die Dekodierungs- und Kodierungsmöglichkeiten für ein gegebenes Format und Ausgabemöglichkeiten offenlegen kann.

Gibt eine Referenz zu einem MediaDevices-Objekt zurück, das verwendet werden kann, um Informationen über verfügbare Mediengeräte zu erhalten (MediaDevices.enumerateDevices()), herauszufinden, welche eingeschränkten Eigenschaften für Medien auf dem Computer des Benutzers und im Benutzeragenten unterstützt werden (MediaDevices.getSupportedConstraints()), und um den Zugriff auf Medien mit MediaDevices.getUserMedia() anzufordern.

Gibt ein MediaSession-Objekt zurück, das verwendet werden kann, um Metadaten bereitzustellen, die vom Browser verwendet werden können, um dem Benutzer Informationen über die aktuell abgespielten Medien, z. B. in einer globalen Mediensteuerungsoberfläche, anzuzeigen.

Gibt einen booleschen Wert zurück, der angibt, ob der Browser online arbeitet.

Gibt true zurück, wenn der Browser PDF-Dateien beim Navigieren zu ihnen inline anzeigen kann, und false andernfalls.

Gibt ein Permissions-Objekt zurück, das verwendet werden kann, um den Berechtigungsstatus von APIs, die von der Permissions API abgedeckt werden, abzufragen und zu aktualisieren.

Gibt eine Referenz zur Presentation-API zurück.

Gibt ein Scheduling-Objekt für das aktuelle Dokument zurück.

Gibt ein Serial-Objekt zurück, das den Einstiegspunkt in die Web Serial API darstellt, um die Steuerung von seriellen Schnittstellen zu ermöglichen.

Gibt ein ServiceWorkerContainer-Objekt zurück, das Zugriff auf Registrierung, Entfernung, Aktualisierung und Kommunikation mit den ServiceWorker-Objekten für das zugehörige Dokument bietet.

Gibt das Singleton-Objekt StorageManager zurück, das zum Verwalten von Persistenzberechtigungen und Schätzung des verfügbaren Speichers auf site-by-site/app-by-app-Basis verwendet wird.

Gibt ein USB-Objekt für das aktuelle Dokument zurück, das Zugriff auf die Funktionalität der WebUSB API bietet.

Gibt ein UserActivation-Objekt zurück, das Informationen über den aktuellen Aktivierungsstatus des Fensters durch den Benutzer enthält.

Gibt den User-Agent-String für den aktuellen Browser zurück.

Gibt ein NavigatorUAData-Objekt zurück, das Zugriff auf Informationen über den Browser und das Betriebssystem des Benutzers bietet.

Gibt eine Referenz zur VirtualKeyboard-API zurück, um die Kontrolle über die virtuelle Bildschirmtastatur zu übernehmen.

Gibt eine WakeLock-Schnittstelle zurück, die Sie verwenden können, um Bildschirmsperren anzufordern und zu verhindern, dass der Bildschirm dimmt, sich ausschaltet oder einen Bildschirmschoner anzeigt.

Gibt an, ob der Benutzeragent durch Automatisierung gesteuert wird.

Gibt die WindowControlsOverlay-Schnittstelle zurück, die Informationen über die Geometrie der Titelleiste in progressiven Web-Apps auf dem Desktop bereitstellt und ein Ereignis, um zu wissen, wann sie sich ändert.

Gibt das XRSystem-Objekt zurück, das den Einstiegspunkt in die WebXR API darstellt.

Nicht-standardisierte Eigenschaften

Gibt die Build-Kennung des Browsers zurück. In modernen Browsern gibt diese Eigenschaft nun aus Datenschutzgründen einen festen Zeitstempel zurück, z.B. 20181001000000 in Firefox 64 und höher.

Gibt einen booleschen Wert zurück, der die Zustimmung des Benutzers zur Weitergabe oder zum Verkauf seiner Informationen angibt.

Gibt einen booleschen Wert zurück, der angibt, ob der Browser im Standalone-Modus läuft. Nur auf Apples iOS Safari verfügbar.

Veraltete Eigenschaften

Gibt ein Array zurück, das jedes VRDisplay-Objekt enthält, das derzeit präsentiert (wenn VRDisplay.isPresenting true ist).

Gibt immer 'Mozilla' zurück, in jedem Browser.

Gibt immer 'Netscape' zurück, in jedem Browser.

Gibt die Version des Browsers als Zeichenkette zurück. Verlassen Sie sich nicht darauf, dass diese Eigenschaft den korrekten Wert zurückgibt.

Gibt den Wert der Do-Not-Track-Präferenz des Benutzers an. Wenn dieser Wert "1" ist, sollte Ihre Website oder Anwendung den Benutzer nicht verfolgen.

Gibt ein MimeTypeArray zurück, das die vom Browser unterstützten MIME-Typen auflistet.

Gibt eine Zeichenkette zurück, die das aktuelle Betriebssystem darstellt.

Gibt eine Zeichenkette zurück, die die Plattform des Browsers darstellt. Verlassen Sie sich nicht darauf, dass diese Funktion einen signifikanten Wert zurückgibt.

Gibt ein PluginArray zurück, das die im Browser installierten Plugins auflistet.

Gibt immer 'Gecko' zurück, in jedem Browser.

Gibt entweder die Zeichenkette '20030107' oder '20100101' zurück.

Gibt entweder die leere Zeichenkette, 'Apple Computer Inc.', oder 'Google Inc.' zurück.

Gibt immer die leere Zeichenkette zurück.

Instanz-Methoden

Erbt keine Methoden.

Gibt true zurück, wenn ein Aufruf von Navigator.share() erfolgreich wäre.

Entfernt ein Badge vom Icon der aktuellen App und gibt ein Promise zurück, das mit undefined aufgelöst wird.

Ersetzt spezifizierte Zeichenfolgen innerhalb der zugeordneten URL, die einer gegebenen undurchsichtigen URN oder der internen url-Eigenschaft von FencedFrameConfig entspricht. Diese Methode wurde vorübergehend verfügbar gemacht (daher "veraltet"), um diese Ersetzung für URLs von gekapselten Rahmen zu ermöglichen und so Anbietern von Werbetechnologien bei der Migration bestehender Implementierungen zu Privacy Sandbox-APIs zu helfen.

Gibt einen Wert zurück, der angibt, ob das angegebene Medien-Element, der Audio-Kontext oder das Medien-Feature "type" automatisch abgespielt werden darf.

Gibt ein Versprechen zurück, das mit einem BatteryManager-Objekt aufgelöst wird, das Informationen über den Ladezustand des Akkus liefert.

Gibt ein Array von Gamepad-Objekten zurück, eines für jedes mit dem Gerät verbundene Gamepad.

Gibt ein Versprechen zurück, das mit einem Array von Objekten aufgelöst wird, die jede verwandte native oder Progresive Web Application darstellen, die der Benutzer installiert hat.

Ermöglicht es Websites, sich als möglicher Handler für ein bestimmtes Protokoll zu registrieren.

Gibt ein Promise für ein MediaKeySystemAccess-Objekt zurück.

Gibt ein Promise zurück, das eine Anfrage für den Zugriff auf MIDI-Geräte im System des Benutzers darstellt.

Wird verwendet, um eine kleine Menge an Daten asynchron mit HTTP vom Benutzeragenten zu einem Web-Server zu übertragen.

Setzt ein Badge auf dem Icon, das mit dieser App verbunden ist, und gibt ein Promise zurück, das mit undefined aufgelöst wird.

Ruft den nativen Teilungsmechanismus der aktuellen Plattform auf.

Verursacht eine Vibration auf Geräten, die diese Funktion unterstützen. Wenn keine Vibrationsunterstützung vorhanden ist, passiert nichts.

Hebt die Registrierung einer Website auf, die ein Handler für ein bestimmtes Protokoll ist.

Veraltete Methoden

Gibt nach Einholung der Erlaubnis durch den Benutzer den Audio- oder Videostream zurück, der einer Kamera oder einem Mikrofon auf dem lokalen Computer zugeordnet ist.

Gibt ein Versprechen zurück, das in ein Array von VRDisplay-Objekten aufgelöst wird, die alle verbundenen VR-Geräte darstellen, die mit dem Computer verbunden sind.

Gibt immer false zurück.

Gibt false zurück. JavaScript-Taint/Untaint-Funktionen wurden in JavaScript 1.2 entfernt.

Spezifikationen

Specification
HTML Standard
# the-navigator-object

Browser-Kompatibilität

BCD tables only load in the browser