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 Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

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

Das Navigator-Interface repräsentiert den Zustand und die Identität des User-Agenten. Es ermöglicht Skripten, ihn abzufragen und sich zu registrieren, um einige Aktivitäten fortzufü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 Zugriff auf die Funktionalität der Web Bluetooth API.

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

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

Gibt eine ContactsManager-Schnittstelle zurück, die 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, wenn nicht.

Gibt die CredentialsContainer-Schnittstelle zurück, die Methoden zum Anfordern von Anmeldeinformationen und zur Benachrichtigung des User-Agenten bei interessanten Ereignissen wie erfolgreichem An- oder Abmelden bietet.

Gibt die Menge des Gerätespeichers in Gigabyte zurück. Dieser Wert ist eine Annäherung, die durch Runden auf die nächste Zweierpotenz gegeben ist und diese Zahl durch 1024 teilt.

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

Gibt ein Geolocation-Objekt zurück, das den Zugriff auf die Position 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 logischen Prozessorkerne zurück, die zur Verfügung stehen.

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

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

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

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

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

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

Bietet Zugriff auf das NavigatorLogin-Objekt des Browsers, das ein identitätsbezogener Anbieter (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 Touch-Kontaktpunkte zurück, die vom aktuellen Gerät unterstützt werden.

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

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

Gibt ein MediaSession-Objekt zurück, das verwendet werden kann, um Metadaten bereitzustellen, die vom Browser verwendet werden können, um Informationen über das aktuell abgespielte Medium dem Benutzer anzuzeigen, etwa in einer globalen Mediensteuerungs-Benutzeroberfläche.

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

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

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

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 serielle Schnittstellen zu ermöglichen.

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

Gibt das Singleton-Objekt StorageManager zurück, das für die Verwaltung von Persistenzberechtigungen und die Schätzung des verfügbaren Speichers auf einer seiten-/anwendungsbasierten Basis verwendet wird.

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

Gibt ein UserActivation-Objekt zurück, das Informationen über den Benutzeraktivierungszustand 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 gibt.

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

Gibt eine WakeLock-Schnittstelle zurück, die verwendet werden kann, um Bildschirm-Aufwach-Sperren anzufordern und zu verhindern, dass der Bildschirm gedimmt wird, ausgeht oder ein Bildschirmschoner angezeigt wird.

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

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

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

Nicht standardmäßige Eigenschaften

Gibt den Build-Bezeichner des Browsers zurück. In modernen Browsern gibt diese Eigenschaft jetzt einen festen Zeitstempel zur Wahrung der Privatsphäre zurück, z. B. 20181001000000 in Firefox 64 und später.

Gibt einen Boolean zurück, der die Zustimmung eines Benutzers zur Weitergabe oder zum Verkauf seiner Informationen angibt.

Gibt einen Boolean zurück, der anzeigt, 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 etwas darstellt (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 Zeichenfolge zurück. Verlassen Sie sich nicht darauf, dass diese Eigenschaft den korrekten Wert zurückgibt.

Meldet den Wert der Do-Not-Track-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 eine Zeichenfolge zurück, die das aktuelle Betriebssystem darstellt.

Gibt eine Zeichenfolge 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 Zeichenfolge '20030107' oder '"20100101' zurück.

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

Gibt immer die leere Zeichenfolge 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 aktuellen App-Symbol und gibt ein Promise zurück, das mit undefined aufgelöst wird.

Ersetzt bestimmte Zeichenfolgen innerhalb der zugeordneten URL, die einem gegebenen undurchsichtigen URN oder der internen url-Eigenschaft von FencedFrameConfig entspricht. Diese Methode wurde als temporäre Maßnahme (daher "veraltet") zur Verfügung gestellt, um diese Ersetzung für fenced frame URLs zu ermöglichen und Ad-Tech-Anbietern beim Migrieren bestehender Implementierungen zu Privacy Sandbox-APIs zu helfen.

Gibt einen Wert zurück, der angibt, ob das angegebene Medienelement, der Audiokontext oder das Media-Feature "typ" automatisch abgespielt werden darf.

Gibt einen Promise zurück, der mit einem BatteryManager-Objekt aufgelöst wird, das Informationen über den Batterieladezustand liefert.

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

Gibt einen Promise zurück, der mit einem Array von Objekten aufgelöst wird, die beliebige verwandte native oder Progressive Web Applications darstellen, die der Benutzer installiert hat.

Erlaubt es Websites, sich selbst als mögliche 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 auf dem System des Benutzers darstellt.

Wird verwendet, um asynchron eine kleine Menge Daten mithilfe von HTTP vom User-Agent an einen Webserver zu übertragen.

Setzt ein Abzeichen auf dem mit dieser App verbundenen Symbol 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. Tut nichts, wenn Vibration nicht unterstützt wird.

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

Veraltete Methoden

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

Gibt ein Promise zurück, das zu einem Array von VRDisplay-Objekten aufgelöst wird, die verfügbare VR-Geräte darstellen, die mit dem Computer verbunden sind.

Gibt immer false zurück.

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

Spezifikationen

Specification
HTML
# the-navigator-object

Browser-Kompatibilität