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 Zustand und die Identität des Benutzeragenten. Es ermöglicht Skripten, Abfragen durchzuführen und sich zu registrieren, um bestimmte Aktivitäten fortzusetzen.

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

Instanzeigenschaften

Erbt keine Eigenschaften.

Standard-Eigenschaften

Navigator.bluetooth Schreibgeschützt Experimentell Sicherer Kontext: Gibt ein Bluetooth-Objekt für das aktuelle Dokument zurück und bietet Zugriff auf die Funktionalitäten der Web Bluetooth API.
Navigator.clipboard Schreibgeschützt Sicherer Kontext: Gibt ein Clipboard-Objekt zurück, das Lese- und Schreibzugriff auf die Systemzwischenablage ermöglicht.
Navigator.connection Schreibgeschützt: Gibt ein NetworkInformation-Objekt zurück, das Informationen über die Netzwerkverbindung eines Geräts enthält.
Navigator.contacts Schreibgeschützt Experimentell Sicherer Kontext: Gibt eine ContactsManager-Schnittstelle zurück, die es Benutzern ermöglicht, Einträge aus ihrer Kontaktliste auszuwählen und eingeschränkte Details der ausgewählten Einträge mit einer Website oder Anwendung zu teilen.
Navigator.cookieEnabled Schreibgeschützt: Gibt false zurück, wenn das Setzen eines Cookies ignoriert wird, andernfalls true.
Navigator.credentials Schreibgeschützt Sicherer Kontext: Gibt die CredentialsContainer-Schnittstelle zurück, die Methoden zum Anfordern von Anmeldeinformationen bereitstellt und den Benutzeragenten bei interessanten Ereignissen wie erfolgreicher Anmeldung oder Abmeldung benachrichtigt.
Navigator.deviceMemory Schreibgeschützt Sicherer Kontext: Gibt die Menge an Gerätespeicher in Gigabyte zurück. Dieser Wert ist eine Annäherung, die durch Runden auf die nächstgelegene Potenz von 2 gegeben wird, und diese Zahl durch 1024 geteilt wird.
Navigator.devicePosture Schreibgeschützt Experimentell: Gibt das DevicePosture-Objekt des Browsers zurück, das es Entwicklern ermöglicht, die aktuelle Haltung des Geräts abzufragen (d.h. ob der Ansichtsbereich in einem flachen oder gefalteten Zustand ist) und Code als Reaktion auf Haltungsänderungen auszuführen.
Navigator.geolocation Schreibgeschützt: Gibt ein Geolocation-Objekt zurück, das den Zugriff auf den Standort des Geräts ermöglicht.
Navigator.gpu Schreibgeschützt Experimentell Sicherer Kontext: Gibt das GPU-Objekt für den aktuellen Browsing-Kontext zurück. Der Einstiegspunkt für die WebGPU API.
Navigator.hardwareConcurrency Schreibgeschützt: Gibt die Anzahl der verfügbaren logischen Prozessorkerne zurück.
Navigator.hid Schreibgeschützt Experimentell Sicherer Kontext: Gibt ein HID-Objekt zurück, das Methoden zum Verbinden mit HID-Geräten, Auflisten angeschlossener HID-Geräte und Ereignisbehandler für verbundene HID-Geräte bereitstellt.
Navigator.ink Schreibgeschützt Experimentell: Gibt ein Ink-Objekt für das aktuelle Dokument zurück, das Zugriff auf die Funktionalität der Ink API bietet.
Navigator.keyboard Schreibgeschützt Experimentell Sicherer Kontext: Gibt ein Keyboard-Objekt zurück, das Zugriff auf Funktionen bietet, die Tastaturlayout-Karten abrufen und das Erfassen von Tastendrücken von der physischen Tastatur umschalten.
Navigator.language Schreibgeschützt: Gibt eine Zeichenfolge zurück, die die bevorzugte Sprache des Benutzers darstellt, normalerweise die Sprache der Benutzeroberfläche des Browsers. Der Wert null wird zurückgegeben, wenn dies unbekannt ist.
Navigator.languages Schreibgeschützt: Gibt ein Array von Zeichenfolgen zurück, die die dem Benutzer bekannten Sprachen in der Reihenfolge ihrer Präferenz darstellen.
Navigator.locks Schreibgeschützt Sicherer Kontext: Gibt ein LockManager-Objekt zurück, das Methoden zum Anfordern eines neuen Lock-Objekts und zur Abfrage eines vorhandenen Lock-Objekts bereitstellt.
Navigator.login Schreibgeschützt Sicherer Kontext: Bietet Zugriff auf das NavigatorLogin-Objekt des Browsers, das von einem föderierten Identitätsanbieter (IdP) genutzt werden kann, um den Anmeldestatus eines Benutzers festzulegen, wenn dieser sich bei oder abmeldet. Siehe Federated Credential Management (FedCM) API für mehr Details.
Navigator.maxTouchPoints Schreibgeschützt: Gibt die maximale Anzahl paralleler Berührungspunkte zurück, die vom aktuellen Gerät unterstützt werden.
Navigator.mediaCapabilities Schreibgeschützt: Gibt ein MediaCapabilities-Objekt zurück, das Informationen über die Dekodierungs- und Kodierungsfähigkeiten für ein gegebenes Format und die Ausgabeoptionen bereitstellen kann.
Navigator.mediaDevices Schreibgeschützt Sicherer Kontext: Gibt eine Referenz zu einem MediaDevices-Objekt zurück, das verwendet werden kann, um Informationen über verfügbare Mediengeräte abzurufen (MediaDevices.enumerateDevices()), um herauszufinden, welche beschränkbaren Eigenschaften für Medien auf dem Computer und Benutzeragent des Benutzers unterstützt werden (MediaDevices.getSupportedConstraints()) und um Zugriff auf Medien zu beantragen mittels MediaDevices.getUserMedia().
Navigator.mediaSession Schreibgeschützt: Gibt das MediaSession-Objekt zurück, das verwendet werden kann, um Metadaten bereitzustellen, die vom Browser genutzt werden können, um Informationen über das aktuell abgespielte Medium anzuzeigen, z. B. in einer globalen Mediensteuerungsoberfläche.
Navigator.onLine Schreibgeschützt: Gibt einen booleschen Wert zurück, der anzeigt, ob der Browser online arbeitet.
Navigator.pdfViewerEnabled Schreibgeschützt: Gibt true zurück, wenn der Browser PDF-Dateien inline anzeigen kann, wenn zu ihnen navigiert wird, und ansonsten false.
Navigator.permissions Schreibgeschützt: Gibt ein Permissions-Objekt zurück, das zum Abfragen und Aktualisieren des Berechtigungsstatus von APIs verwendet werden kann, die von der Permissions API abgedeckt werden.
Navigator.presentation Schreibgeschützt Sicherer Kontext: Gibt eine Referenz zur Presentation API zurück.
Navigator.scheduling Schreibgeschützt Experimentell: Gibt ein Scheduling-Objekt für das aktuelle Dokument zurück.
Navigator.serial Schreibgeschützt Experimentell Sicherer Kontext: Gibt ein Serial-Objekt zurück, das den Einstiegspunkt in die Web Serial API darstellt, um die Steuerung von seriellen Ports zu ermöglichen.
Navigator.serviceWorker Schreibgeschützt Sicherer Kontext: 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.
Navigator.storage Schreibgeschützt Sicherer Kontext: Gibt das Singleton StorageManager-Objekt zurück, das zur Verwaltung von Persistenzberechtigungen und zur Abschätzung des verfügbaren Speichers auf einer site-/anwendungsbezogenen Basis verwendet wird.
Navigator.usb Schreibgeschützt Sicherer Kontext: Gibt ein USB-Objekt für das aktuelle Dokument zurück und bietet Zugriff auf die Funktionalität der WebUSB API.
Navigator.userActivation Schreibgeschützt: Gibt ein UserActivation-Objekt zurück, das Informationen über den Aktivierungsstatus des aktuellen Fensters bereitstellt.
Navigator.userAgent Schreibgeschützt: Gibt den User-Agent-String für den aktuellen Browser zurück.
Navigator.userAgentData Schreibgeschützt Experimentell Sicherer Kontext: Gibt ein NavigatorUAData-Objekt zurück, das Zugriff auf Informationen über den Browser und das Betriebssystem des Benutzers bietet.
Navigator.virtualKeyboard Schreibgeschützt Experimentell Sicherer Kontext: Gibt eine Referenz zur VirtualKeyboard API zurück, um die Steuerung der virtuellen Bildschirmtastatur zu übernehmen.
Navigator.wakeLock Schreibgeschützt Sicherer Kontext: Gibt eine WakeLock-Schnittstelle zurück, die Sie verwenden können, um Bildschirm-Wake-Locks anzufordern und zu verhindern, dass der Bildschirm abgeblendet wird, sich ausschaltet oder einen Bildschirmschoner anzeigt.
Navigator.webdriver Schreibgeschützt: Zeigt an, ob der Benutzeragent von einer Automatisierung kontrolliert wird.
Navigator.windowControlsOverlay Schreibgeschützt Sicherer Kontext: Gibt die WindowControlsOverlay-Schnittstelle zurück, die Informationen über die Geometrie der Titelleiste in Desktop Progressive Web Apps sowie ein Ereignis bereitstellt, um zu wissen, wann diese sich ändert.
Navigator.xr Schreibgeschützt Experimentell Sicherer Kontext: Gibt das XRSystem-Objekt zurück, das den Einstiegspunkt in die WebXR API darstellt.

Nicht-standardisierte Eigenschaften

Navigator.buildID Schreibgeschützt Nicht standardisiert: Gibt die Build-ID des Browsers zurück. In modernen Browsern gibt diese Eigenschaft jetzt einen festen Zeitstempel als Datenschutzmaßnahme zurück, z. B. 20181001000000 ab Firefox 64.
Navigator.globalPrivacyControl Schreibgeschützt Experimentell: Gibt einen booleschen Wert zurück, der die Zustimmung eines Benutzers anzeigt, dass seine Informationen geteilt oder verkauft werden dürfen.
Navigator.standalone Nicht standardisiert: Gibt einen booleschen Wert zurück, der anzeigt, ob der Browser im Standalone-Modus läuft. Nur auf Apples iOS Safari verfügbar.

Veraltete Eigenschaften

Navigator.activeVRDisplays Schreibgeschützt Veraltet Nicht standardisiert: Gibt ein Array zurück, das jedes VRDisplay-Objekt enthält, das derzeit präsentiert wird (VRDisplay.isPresenting ist true).
Navigator.appCodeName Schreibgeschützt Veraltet: Gibt immer 'Mozilla' zurück, in jedem Browser.
Navigator.appName Schreibgeschützt Veraltet: Gibt immer 'Netscape' zurück, in jedem Browser.
Navigator.appVersion Schreibgeschützt Veraltet: Gibt die Version des Browsers als Zeichenfolge zurück. Verlassen Sie sich nicht darauf, dass diese Eigenschaft den korrekten Wert zurückgibt.
Navigator.doNotTrack Schreibgeschützt Veraltet Nicht standardisiert: Berichtet den Wert der "Do Not Track"-Einstellung des Benutzers. Wenn dieser Wert "1" ist, sollte Ihre Website oder Anwendung den Benutzer nicht verfolgen.
Navigator.mimeTypes Schreibgeschützt Veraltet: Gibt ein MimeTypeArray zurück, das die vom Browser unterstützten MIME-Typen auflistet.
Navigator.oscpu Schreibgeschützt Veraltet: Gibt einen String zurück, der das aktuelle Betriebssystem repräsentiert.
Navigator.platform Schreibgeschützt Veraltet: Gibt einen String zurück, der die Plattform des Browsers repräsentiert. Verlassen Sie sich nicht darauf, dass diese Funktion einen signifikanten Wert zurückgibt.
Navigator.plugins Schreibgeschützt Veraltet: Gibt ein PluginArray zurück, das die im Browser installierten Plugins auflistet.
Navigator.product Schreibgeschützt Veraltet: Gibt immer 'Gecko' zurück, in jedem Browser.
Navigator.productSub Schreibgeschützt Veraltet: Gibt entweder den String '20030107' oder '"20100101' zurück.
Navigator.vendor Schreibgeschützt Veraltet: Gibt entweder den leeren String, 'Apple Computer Inc.' oder 'Google Inc.' zurück.
Navigator.vendorSub Schreibgeschützt Veraltet: Gibt immer den leeren String zurück.

Instanzmethoden

Erbt keine Methoden.

Navigator.canShare() Sicherer Kontext: Gibt true zurück, wenn ein Aufruf von Navigator.share() erfolgreich wäre.
Navigator.clearAppBadge() Sicherer Kontext: Löscht das Abzeichen auf dem Symbol der aktuellen App und gibt ein Promise zurück, das mit undefined aufgelöst wird.
Navigator.deprecatedReplaceInURN() Experimentell: Ersetzt bestimmte Zeichenfolgen innerhalb der zugehörigen URL, die einem gegebenen undurchsichtigen URN oder der internen url-Eigenschaft eines FencedFrameConfig zugeordnet ist. Diese Methode wurde als vorübergehende Maßnahme zur Verfügung gestellt (daher "deprecated"), um die Ersetzung für fenced frame URLs zu ermöglichen und Werbetechnologie-Anbietern zu helfen, vorhandene Implementierungen auf Privacy Sandbox APIs zu migrieren.
Navigator.getAutoplayPolicy() Experimentell: Gibt einen Wert zurück, der anzeigt, ob das angegebene Medien-Element, die Audio-Kontext oder das Medien-Feature "type" automatisch abgespielt werden darf.
Navigator.getBattery() Sicherer Kontext: Gibt ein Versprechen zurück, das mit einem BatteryManager-Objekt aufgelöst wird, das Informationen über den Ladezustand der Batterie zurückgibt.
Navigator.getGamepads(): Gibt ein Array von Gamepad-Objekten zurück, eines für jedes mit dem Gerät verbundene Gamepad.
Navigator.getInstalledRelatedApps() Experimentell Sicherer Kontext: Gibt ein Versprechen zurück, das mit einem Array von Objekten aufgelöst wird, die verwandte native oder Progressive Web Applications darstellen, die der Benutzer installiert hat.
Navigator.registerProtocolHandler() Sicherer Kontext: Erlaubt es Websites, sich selbst als möglichen Handler für ein gegebenes Protokoll zu registrieren.
Navigator.requestMediaKeySystemAccess() Sicherer Kontext: Gibt ein Promise für ein MediaKeySystemAccess-Objekt zurück.
Navigator.requestMIDIAccess() Sicherer Kontext: Gibt ein Promise zurück, das einen Zugriffsanforderung auf MIDI-Geräte des Systems des Benutzers darstellt.
Navigator.sendBeacon(): Wird verwendet, um asynchron eine kleine Datenmenge mit HTTP vom Benutzeragenten an einen Webserver zu übertragen.
Navigator.setAppBadge() Sicherer Kontext: Setzt ein Abzeichen auf dem mit dieser App verknüpften Symbol und gibt ein Promise zurück, das mit undefined aufgelöst wird.
Navigator.share() Sicherer Kontext: Ruft den nativen Freigabemechanismus der aktuellen Plattform auf.
Navigator.vibrate(): Verursacht Vibration auf Geräten, die es unterstützen. Macht nichts, wenn kein Vibrationssupport verfügbar ist.
Navigator.unregisterProtocolHandler() Sicherer Kontext: Hebt die Registrierung einer Website auf, die ein Handler für ein gegebenes Protokoll ist.

Veraltete Methoden

Navigator.getUserMedia() Veraltet Sicherer Kontext: Nachdem dem Benutzer die Erlaubnis erteilt wurde, wird der Audio- oder Videostream zurückgegeben, der mit einer Kamera oder einem Mikrofon auf dem lokalen Computer verbunden ist.
Navigator.getVRDisplays() Veraltet Nicht standardisiert: Gibt ein Versprechen 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.
Navigator.javaEnabled() Veraltet: Gibt immer false zurück.
Navigator.taintEnabled() Veraltet: Gibt false zurück. JavaScript taint/untaint Funktionen wurden in JavaScript 1.2 entfernt.

Spezifikationen

Specification
HTML # the-navigator-object