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 User-Agent. Es ermöglicht Skripten, Informationen darüber abzufragen und sich zu registrieren, um bestimmte Aktivitäten auszuführen.

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 und bietet Zugang zur Web Bluetooth API.

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

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

Gibt eine ContactsManager-Schnittstelle zurück, die es 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, andernfalls true.

Gibt die CredentialsContainer-Schnittstelle zurück, die Methoden zur Anforderung von Anmeldeinformationen und zur Benachrichtigung des User-Agent bei interessanten Ereignissen wie erfolgreichem An- oder Abmelden freigibt.

Gibt die Menge an Gerätespeicher 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 erzielt 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, zur Auflistung angeschlossener HID-Geräte und zu Ereignishandlern für angeschlossene HID-Geräte bietet.

Gibt ein Ink-Objekt für das aktuelle Dokument zurück und bietet Zugriff auf die Ink API.

Gibt ein Keyboard-Objekt zurück, das den Zugriff auf Funktionen bietet, die Tastatur-Layoutzuordnungen abrufen und das Erfassen von Tastendrücken der physischen Tastatur umschalten.

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

Gibt ein Array von Strings 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 bietet.

Bietet Zugriff auf das NavigatorLogin-Objekt des Browsers, das ein föderierter Identitätsanbieter (IdP) verwenden kann, um den Anmeldestatus eines Benutzers festzulegen, wenn er sich beim IdP anmeldet oder abmeldet. Weitere Details 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 Kodierungsfähigkeiten für ein gegebenes Format und Ausgabefähigkeiten offenlegen kann.

Gibt eine Referenz auf ein MediaDevices-Objekt zurück, das dann verwendet werden kann, um Informationen über verfügbare Mediengeräte zu erhalten (MediaDevices.enumerateDevices()), herauszufinden, welche einschränkbaren Eigenschaften für Medien auf dem Computer des Benutzers und dem User-Agent unterstützt werden (MediaDevices.getSupportedConstraints()), und um Zugang zu Medien mit MediaDevices.getUserMedia() zu beantragen.

Gibt ein MediaSession-Objekt zurück, das verwendet werden kann, um Metadaten bereitzustellen, die der Browser verwenden kann, um Informationen über die aktuell abgespielten Medien dem Benutzer zu präsentieren, wie in einer globalen Mediensteuerungs-Benutzeroberfläche.

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

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

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

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, das den Einstiegspunkt in die Web Serial API darstellt, um die Kontrolle über serielle Anschlüsse zu ermöglichen.

Gibt ein ServiceWorkerContainer-Objekt zurück, das Zugang zu Registrierung, Entfernung, Aktualisierung und Kommunikation mit den ServiceWorker-Objekten für das assoziierte Dokument bietet.

Gibt das Singleton-Objekt StorageManager zurück, das zum Verwalten von Persistenzberechtigungen und zum Schätzen des verfügbaren Speichers auf einer Standort-zu-Standort-App-zu-App-Basis verwendet wird.

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

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

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

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

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

Gibt eine WakeLock-Schnittstelle zurück, die Sie zum Anfordern von Bildschirmwachschlössern verwenden können, um das Abdunkeln des Bildschirms, das Ausschalten oder das Anzeigen eines Bildschirmschoners zu verhindern.

Gibt an, ob der User-Agent von der Automatisierung gesteuert wird.

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

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

Nicht-standardmäßige Eigenschaften

Gibt die Build-Kennung des Browsers zurück. In modernen Browsern gibt diese Eigenschaft jetzt einen festen Zeitstempel als Datenschutzmaßnahme zurück, z. B. 20181001000000 in Firefox 64 und höher.

Gibt einen Boolean zurück, der anzeigt, ob ein Benutzer seine Zustimmung zur Weitergabe oder zum Verkauf seiner Informationen erteilt hat.

Gibt einen Boolean zurück, der angibt, ob der Browser im Standalone-Modus ausgeführt wird. Verfügbar nur in Apples iOS Safari.

Veraltete Eigenschaften

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

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

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

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

Berichtet den Wert der Nicht-verfolgen-Präferenz des Benutzers. 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 darstellt.

Gibt einen String zurück, der die Plattform des Browsers darstellt. Verlassen Sie sich nicht darauf, dass diese Funktion einen wesentlichen 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 den String '20030107' oder '20100101' zurück.

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

Gibt immer den leeren String zurück.

Instanz-Methoden

Erbt keine Methoden.

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

Löscht ein Abzeichen auf dem Symbol der aktuellen App und gibt ein Promise zurück, welches mit undefined aufgelöst wird.

Ersetzt angegebene Strings innerhalb der zugehörigen URL, die einem bestimmten undurchsichtigen URN oder der internen url-Eigenschaft einer FencedFrameConfig zugeordnet ist. Diese Methode wurde vorübergehend zur Verfügung gestellt (daher "veraltet"), um diese Ersetzung für fenced frame URLs zu ermöglichen und Ad-Tech-Anbieter dabei zu unterstützen, bestehende Implementierungen auf Privacy Sandbox-APIs zu migrieren.

Gibt einen Wert zurück, der angibt, ob das angegebene Medienelement, der Audiokontext oder die Medienfunktion "type" automatisch abgespielt werden darf.

Gibt ein Promise zurück, das mit einem BatteryManager-Objekt aufgelöst wird, das Informationen über den Batterie-Ladestatus liefert.

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 aufgelöst wird, die alle verwandten nativen oder Progressive Web Applications darstellen, die der Benutzer installiert hat.

Ermöglicht es Websites, sich selbst als möglichen Handler für ein gegebenes 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 asynchron eine kleine Datenmenge über HTTP vom User-Agent an einen Webserver zu übertragen.

Setzt ein Abzeichen auf das Symbol, das mit dieser App verknüpft ist, und gibt ein Promise zurück, welches mit undefined aufgelöst wird.

Ruft den nativen Freigabemechanismus der aktuellen Plattform auf.

Verursacht Vibration auf Geräten, die dies unterstützen. Tut nichts, wenn Vibrationsunterstützung nicht verfügbar ist.

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

Veraltete Methoden

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

Gibt ein Promise zurück, das mit einem Array von VRDisplay-Objekten aufgelöst wird, die alle verfügbaren 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