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.

Das Navigator-Interface repräsentiert den Zustand und die Identität des User-Agents. Es ermöglicht Skripten, Abfragen zu stellen und sich für bestimmte Aktivitäten anzumelden.

Ein Navigator-Objekt kann mit der schreibgeschützten window.navigator-Eigenschaft abgerufen werden.

Instanz-Eigenschaften

Erbt keine Eigenschaften.

Standard-Eigenschaften

Gibt ein AudioSession-Objekt zurück, das verwendet werden kann, um zu steuern, wie Audio aus der Webanwendung mit anderen Audios auf dem Gerät interagiert.

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 Systemzwischenspeicherung ermöglicht.

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

Gibt eine ContactsManager-Schnittstelle zurück, die es Nutzern 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 zum Anfordern von Anmeldeinformationen und zum Benachrichtigen des User-Agents über interessante Ereignisse wie erfolgreiche An- oder Abmeldungen bereitstellt.

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

Gibt das DevicePosture-Objekt des Browsers zurück, das Entwicklern ermöglicht, die aktuelle Haltung des Geräts zu ermitteln (ob der Viewport in einem flachen oder gefalteten Zustand ist) und Code in Reaktion auf Haltungverä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 logischen Prozessorkerne zurück, die verfügbar sind.

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

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, welches Zugriff auf Funktionen bietet, die Tastaturlayouts abrufen und das Erfassen von Tastenanschlägen der physischen Tastatur umschalten.

Gibt einen String zurück, der die bevorzugte Sprache des Nutzers 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, das die dem Nutzer bekannten Sprachen in der Reihenfolge der Präferenz repräsentiert.

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, das von einem föderierten Identitätsanbieter (IdP) verwendet werden kann, um den Anmeldestatus eines Nutzers festzulegen, wenn er sich beim IdP an- oder abmeldet. Weitere Einzelheiten finden Sie in der Federated Credential Management (FedCM) API.

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

Gibt ein MediaCapabilities-Objekt zurück, das Informationen über die Dekodierungs- und Kodierungsfähigkeiten für ein bestimmtes Format und die Ausgabekapazitäten 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 Nutzers und User-Agent unterstützt werden (MediaDevices.getSupportedConstraints()), und um Zugang zu Medien anzufordern, indem man MediaDevices.getUserMedia() verwendet.

Gibt das MediaSession-Objekt zurück, welches verwendet werden kann, um Metadaten bereitzustellen, die vom Browser genutzt werden können, um Informationen über die aktuell abgespielten Medien für den Nutzer darzustellen, wie z.B. in einer globalen Mediensteuerungs-UI.

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

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

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

Gibt das aktuelle PreferenceManager-Objekt des Dokuments zurück, das Zugriff auf Informationen zu Benutzervoreinstellungen 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, das den Einstiegspunkt in die Web Serial API darstellt, um die Steuerung von seriellen Ports zu ermöglichen.

Gibt ein ServiceWorkerContainer-Objekt zurück, welches Zugang zur Registrierung, Entfernung, Aktualisierung und Kommunikation mit den ServiceWorker-Objekten des zugehörigen Dokuments bietet.

Gibt das Singleton StorageManager-Objekt zurück, das zum Verwalten von Persistenzberechtigungen und zur Schätzung des verfügbaren Speichers auf einer Site-zu-Site/App-zu-App-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 Aktivierungsstatus des aktuellen Fensters 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 Nutzers 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 Bildschirmaufweck-Sperren verwenden können, um zu verhindern, dass der Bildschirm abgedunkelt wird, sich ausschaltet 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 offenbart und ein Ereignis, um zu wissen, wann immer es sich ändert.

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

Nicht-standardisierte Eigenschaften

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

Gibt einen booleschen Wert zurück, der die Zustimmung eines Nutzers angibt, dass seine Informationen geteilt oder verkauft werden.

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

Veraltete Eigenschaften

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

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

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

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

Meldet den Wert der Datenschutzpräferenz des Nutzers. 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 signifikanten Wert zurückgibt.

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.

Instanz-Methoden

Erbt keine Methode.

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 Strings innerhalb der abgebildeten URL, die einer bestimmten undurchsichtigen URN oder der internen url-Eigenschaft von FencedFrameConfig entspricht. Diese Methode wurde vorübergehend (daher "veraltet") zur Verfügung gestellt, um diese Ersetzung für fenced frame-URLs zu ermöglichen, damit Anbieter von Werbetechnologien bestehende Implementierungen auf die Privacy Sandbox APIs umstellen können.

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

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

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 eine vom Nutzer installierte verwandte native oder Progressive Web Anwendungen darstellen.

Ermöglicht es Websites, sich als möglicher 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 zum Zugriff auf MIDI-Geräte auf dem System des Nutzers darstellt.

Wird verwendet, um asynchron eine kleine Menge an Daten unter Verwendung von HTTP vom User-Agent an einen Web-Server zu übertragen.

Setzt ein Badge auf dem mit dieser App verknüpften 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 Vibrationsunterstützung nicht verfügbar ist.

Eine Website, die ein Handler für ein gegebenes Protokoll ist, abmelden.

Veraltete Methoden

Gibt nach der Aufforderung an den Nutzer um Erlaubnis 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 in ein Array von VRDisplay-Objekten aufgelöst wird, die VR-Geräte darstellen, die an den Computer angeschlossen sind.

Gibt immer false zurück.

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

Spezifikationen

Spezifikation
HTML
# the-navigator-object

Browser-Kompatibilität