Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Navigator

Baseline
Weitgehend verfügbar
*

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Die Navigator-Schnittstelle repräsentiert den Zustand und die Identität des User Agents. Sie ermöglicht es Skripten, diese Informationen abzufragen und sich für bestimmte Aktivitäten zu registrieren.

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

Instanzeigenschaften

Erbt keine Eigenschaften.

Standardeigenschaften

Gibt ein AudioSession-Objekt zurück, mit dem sich steuern lässt, wie Audio der Webanwendung mit anderer Audiowiedergabe auf dem Gerät zusammenspielt.

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

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

Gibt ein NetworkInformation-Objekt mit Informationen über die Netzwerkverbindung eines Geräts zurück.

Gibt eine ContactsManager-Schnittstelle zurück, über die Benutzer Einträge aus ihrer Kontaktliste auswählen und begrenzte Informationen zu den ausgewählten Einträgen mit einer Website oder Anwendung teilen können.

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

Gibt die CredentialsContainer-Schnittstelle zurück. Sie stellt Methoden zum Anfordern von Anmeldedaten und zum Benachrichtigen des User Agents über Ereignisse wie eine erfolgreiche Anmeldung oder Abmeldung bereit.

Gibt die Größe des Gerätespeichers in Gigabyte zurück. Der Wert ist ein Näherungswert: Die Speichergröße wird auf die nächste Zweierpotenz gerundet und das Ergebnis durch 1024 geteilt.

Gibt das DevicePosture-Objekt des Browsers zurück. Damit können Entwickler den aktuellen Zustand des Geräts abfragen – also ob der Viewport flach oder gefaltet ist – und auf Zustandsänderungen mit Code reagieren.

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. Es ist 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 und zum Auflisten angeschlossener HID-Geräte sowie Event-Handler für verbundene HID-Geräte bereitstellt.

Gibt ein Ink-Objekt für das aktuelle Dokument zurück, das Zugriff auf Funktionen der Ink API bietet.

Gibt ein Keyboard-Objekt zurück. Es bietet Zugriff auf Funktionen zum Abrufen von Tastaturlayouts und zum Aktivieren oder Deaktivieren der Erfassung von Tastendrücken auf der physischen Tastatur.

Gibt einen String zurück, der die bevorzugte Sprache des Benutzers angibt, üblicherweise die Sprache der Browseroberfläche. Ist sie unbekannt, wird null zurückgegeben.

Gibt ein Array von Strings zurück, das die dem Benutzer bekannten Sprachen in der Reihenfolge seiner Präferenzen enthält.

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

Bietet Zugriff auf das NavigatorLogin-Objekt des Browsers. Ein föderierter Identitätsanbieter (IdP) kann damit den Anmeldestatus eines Benutzers festlegen, wenn dieser sich beim IdP an- oder abmeldet. Weitere Informationen finden Sie unter Federated Credential Management (FedCM) API.

Gibt die maximale Anzahl gleichzeitiger Touch-Kontaktpunkte zurück, die das aktuelle Gerät unterstützt.

Gibt ein MediaCapabilities-Objekt zurück, das Informationen über die Decodierungs- und Codierungsfähigkeiten für ein bestimmtes Format sowie über Ausgabefähigkeiten bereitstellen kann.

Gibt eine Referenz auf ein MediaDevices-Objekt zurück. Damit lassen sich Informationen über verfügbare Mediengeräte abrufen (MediaDevices.enumerateDevices()), die unterstützten einstellbaren Eigenschaften für Medien auf dem Computer des Benutzers und im User Agent ermitteln (MediaDevices.getSupportedConstraints()) und über MediaDevices.getUserMedia() Zugriff auf Medien anfordern.

Gibt ein MediaSession-Objekt zurück. Darüber können Metadaten bereitgestellt werden, mit denen der Browser dem Benutzer Informationen über aktuell wiedergegebene Medien anzeigen kann, etwa in einer globalen Oberfläche zur Mediensteuerung.

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

Gibt true zurück, wenn der Browser PDF-Dateien beim Aufrufen direkt anzeigen kann, andernfalls false.

Gibt ein Permissions-Objekt zurück, mit dem sich der Berechtigungsstatus von APIs abfragen und aktualisieren lässt, die von der Permissions API abgedeckt werden.

Gibt das aktuelle PreferenceManager-Objekt des Dokuments zurück, das Zugriff auf Informationen über Benutzereinstellungen bietet.

Gibt eine Referenz auf die Presentation API zurück.

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

Gibt ein Serial-Objekt zurück. Es ist der Einstiegspunkt für die Web Serial API, mit der sich serielle Schnittstellen steuern lassen.

Gibt ein ServiceWorkerContainer-Objekt zurück. Es ermöglicht die Registrierung, Entfernung und Aktualisierung von ServiceWorker-Objekten sowie die Kommunikation mit ihnen für das zugehörige Dokument.

Gibt das einzige StorageManager-Objekt zurück, mit dem Berechtigungen für dauerhafte Speicherung verwaltet und der verfügbare Speicherplatz je Website oder Anwendung geschätzt werden kann.

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

Gibt ein UserActivation-Objekt mit Informationen über den aktuellen Benutzeraktivierungsstatus des Fensters zurück.

Gibt den User-Agent-String des aktuellen Browsers zurück.

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

Gibt eine Referenz auf die VirtualKeyboard API zurück, mit der sich die virtuelle Bildschirmtastatur steuern lässt.

Gibt eine WakeLock-Schnittstelle zurück, über die Sie Screen Wake Locks anfordern können, um zu verhindern, dass der Bildschirm abgedunkelt oder ausgeschaltet wird oder ein Bildschirmschoner erscheint.

Gibt an, ob der User Agent durch Automatisierung gesteuert wird.

Gibt die WindowControlsOverlay-Schnittstelle zurück. Sie stellt Informationen über die Geometrie der Titelleiste in Desktop-Progressive-Web-Apps sowie ein Event für Änderungen daran bereit.

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

Nicht standardisierte Eigenschaften

Gibt die Build-Kennung des Browsers zurück. In modernen Browsern liefert diese Eigenschaft aus Datenschutzgründen inzwischen einen festen Zeitstempel zurück, beispielsweise 20181001000000 in Firefox ab Version 64.

Gibt einen booleschen Wert zurück, der angibt, ob ein Benutzer der Weitergabe oder dem Verkauf seiner Informationen zugestimmt hat.

Gibt einen booleschen Wert zurück, der angibt, ob der Browser im Standalone-Modus ausgeführt wird. Nur in Safari unter Apple iOS verfügbar.

Veraltete Eigenschaften

Gibt ein Array mit allen VRDisplay-Objekten zurück, die aktuell Inhalte präsentieren (VRDisplay.isPresenting ist true).

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

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

Gibt die Browserversion als String zurück. Verlassen Sie sich nicht darauf, dass diese Eigenschaft den korrekten Wert liefert.

Gibt den Wert der Do-Not-Track-Einstellung 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 einen String zurück, der das aktuelle Betriebssystem angibt.

Gibt einen String zurück, der die Plattform des Browsers angibt. Verlassen Sie sich nicht darauf, dass diese Eigenschaft einen aussagekräftigen Wert liefert.

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

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

Gibt entweder den String '20030107' oder '"20100101' zurück.

Gibt entweder den leeren String, 'Apple Computer Inc.' oder 'Google Inc.' zurück.

Gibt immer den leeren String zurück.

Instanzmethoden

Erbt keine Methoden.

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

Entfernt ein Badge vom Symbol der aktuellen App und gibt ein Promise zurück, das mit undefined erfüllt wird.

Ersetzt bestimmte Strings innerhalb der zugeordneten URL, die einer gegebenen opaken URN oder der internen url-Eigenschaft eines FencedFrameConfig entspricht. Diese Methode wurde als vorübergehende Maßnahme bereitgestellt – daher „deprecated“ –, um diese Ersetzung für URLs von Fenced Frames zu ermöglichen und Anbietern von Werbetechnologie die Migration bestehender Implementierungen zu Privacy-Sandbox-APIs zu erleichtern.

Gibt einen Wert zurück, der angibt, ob das angegebene Medienelement, der Audiokontext oder der „Typ“ der Medienfunktion automatisch wiedergegeben werden darf.

Gibt ein Promise zurück, das mit einem BatteryManager-Objekt erfüllt wird, das Informationen über den Ladezustand des Akkus bereitstellt.

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

Gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird, die zugehörige native Anwendungen oder Progressive Web Applications repräsentieren, die der Benutzer installiert hat.

Ermöglicht 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 auf Zugriff auf MIDI-Geräte im System des Benutzers repräsentiert.

Dient dazu, eine kleine Datenmenge asynchron mittels HTTP vom User Agent an einen Webserver zu übertragen.

Setzt ein Badge auf das dieser App zugeordnete Symbol und gibt ein Promise zurück, das mit undefined erfüllt wird.

Ruft den nativen Freigabemechanismus der aktuellen Plattform auf.

Löst auf Geräten, die dies unterstützen, eine Vibration aus. Ist keine Vibrationsunterstützung verfügbar, geschieht nichts.

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

Veraltete Methoden

Fragt den Benutzer nach seiner Berechtigung und gibt anschließend den Audio- oder Videostream einer Kamera oder eines Mikrofons am lokalen Computer zurück.

Gibt ein Promise zurück, das mit einem Array von VRDisplay-Objekten erfüllt wird, die alle verfügbaren, mit dem Computer verbundenen VR-Geräte repräsentieren.

Gibt immer false zurück.

Gibt false zurück. Die JavaScript-Funktionen für taint/untaint wurden in JavaScript 1.2 entfernt.

Spezifikationen

Spezifikation
HTML
# the-navigator-object

Browser-Kompatibilität