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.

* Some parts of this feature may have varying levels of support.

Das Navigator-Interface repräsentiert den Status und die Identität des Benutzeragenten. Es ermöglicht Skripten, Abfragen durchzuführen und sich selbst 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 und bietet Zugriff auf die Web Bluetooth API-Funktionalität.

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 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 bereitstellt, um Anmeldeinformationen anzufordern und den Benutzeragenten über interessante Ereignisse wie erfolgreiche An- oder Abmeldung zu informieren.

Gibt die Menge an Gerätespeicher in Gigabyte zurück. Dieser Wert ist eine Annäherung, die durch Rundung auf die nächste Zweierpotenz und Teilung dieser Zahl durch 1024 gegeben ist.

Gibt das DevicePosture-Objekt des Browsers zurück, das es Entwicklern ermöglicht, die aktuelle Haltung des Geräts abzufragen (d.h. ob das Ansichtsfenster flach oder gefaltet ist) und Code als Reaktion auf Haltungsänderungen auszuführen.

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 verbundene HID-Geräte bietet.

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

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

Gibt einen String zurück, der die bevorzugte Sprache des Benutzers repräsentiert, normalerweise die Sprache der Browser-Benutzeroberfläche. Der Wert null wird zurückgegeben, wenn dies 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 Informationen 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 bereitstellen kann.

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

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

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

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

Gibt ein Permissions-Objekt zurück, das verwendet werden kann, um den Berechtigungsstatus von APIs, die von der Permissions API abgedeckt sind, 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 Anschlüssen zu ermöglichen.

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

Gibt das Singleton StorageManager-Objekt zurück, das zur Verwaltung von Persistenzberechtigungen und zur Schätzung des verfügbaren Speichers auf einer site- oder app-basierten Basis verwendet wird.

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

Gibt ein UserActivation-Objekt zurück, das Informationen über den Benutzernaktivierungsstatus des aktuellen Fensters 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 On-Screen-Tastatur zu übernehmen.

Gibt eine WakeLock-Schnittstelle zurück, die verwendet werden kann, um Bildschirm-Wachschlösser anzufordern und zu verhindern, dass der Bildschirm gedimmt, ausgeschaltet oder der Bildschirmschoner aktiviert wird.

Gibt an, ob der Benutzeragent durch Automation gesteuert wird.

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

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

Nicht-standardisierte Eigenschaften

Gibt die Buildkennung des Browsers zurück. In modernen Browsern gibt diese Eigenschaft jetzt als Datenschutzmaßnahme einen festen Zeitstempel zurück, z.B. 20181001000000 ab Firefox 64.

Gibt einen booleschen Wert zurück, der die Einwilligung des Benutzers zur Weitergabe oder zum Verkauf ihrer 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 (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.

Gibt den Wert der "Do not track"-Einstellung des Benutzers zurück. 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 repräsentiert.

Gibt einen String zurück, der die Plattform des Browsers repräsentiert. Verlassen Sie sich nicht darauf, dass diese Funktion einen bedeutenden 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 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.

Löscht ein Badge auf dem Icon der aktuellen App und gibt ein Promise zurück, das mit undefined aufgelöst wird.

Ersetzt angegebene Zeichenfolgen innerhalb der zugeordneten URL, die einem bestimmten undurchsichtigen URN oder der internen url-Eigenschaft von FencedFrameConfig entspricht. Diese Methode wurde als temporäre Maßnahme (daher "veraltet") bereitgestellt, um diesen Ersatz für eingezäunte Frame-URLs zu ermöglichen und Anbietern von Werbetechnologie zu helfen, bestehende Implementierungen auf Privacy Sandbox-APIs zu migrieren.

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

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

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

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 um Zugang zu MIDI-Geräten auf dem System des Benutzers repräsentiert.

Wird verwendet, um eine kleine Menge von Daten asynchron mit HTTP vom Benutzeragenten zu einem Webserver zu übertragen.

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

Ruft den nativen Freigabemechanismus der aktuellen Plattform auf.

Verursacht Vibrationen auf Geräten, die dies unterstützen. Macht nichts, wenn keine Vibrationen unterstützt werden.

Meldet eine Website ab, die ein Handler für ein gegebenes Protokoll ist.

Veraltete Methoden

Nach der Erlaubnisanfrage des Benutzers wird der Audio- oder Videostream zurückgegeben, 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-Funktionalitäten für "taint/untaint" wurden in JavaScript 1.2 entfernt.

Spezifikationen

Specification
HTML
# the-navigator-object

Browser-Kompatibilität