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.
Die Navigator-Schnittstelle repräsentiert den Zustand und die Identität des User Agents. Sie ermöglicht es Skripten, diese Informationen abzufragen und sich für bestimmte Aktivitäten zu registrieren.
Ein Navigator-Objekt kann über die schreibgeschützte Eigenschaft window.navigator abgerufen werden.
Instanzeigenschaften
Erbt keine Eigenschaften.
Standardeigenschaften
-
Gibt ein
AudioSession-Objekt zurück, mit dem gesteuert werden kann, wie Audio der Webanwendung mit anderer Audiowiedergabe auf dem Gerät zusammenwirkt. -
Gibt ein
Bluetooth-Objekt für das aktuelle Dokument zurück, das Zugriff auf die Funktionen der Web Bluetooth API bietet. -
Gibt ein
Clipboard-Objekt zurück, das Lese- und Schreibzugriff auf die Zwischenablage des Systems bietet. -
Gibt ein
NetworkInformation-Objekt mit Informationen über die Netzwerkverbindung eines Geräts zurück. -
Gibt eine
ContactsManager-Schnittstelle zurück, über die Benutzer Einträge aus ihrer Kontaktliste auswählen und begrenzte Informationen zu den ausgewählten Einträgen mit einer Website oder Anwendung teilen können. -
Gibt
falsezurück, wenn das Setzen eines Cookies ignoriert wird, andernfallstrue. -
Gibt die
CredentialsContainer-Schnittstelle zurück. Sie stellt Methoden bereit, um Anmeldedaten anzufordern und den User Agent über Ereignisse wie eine erfolgreiche An- oder Abmeldung zu benachrichtigen. -
Gibt die Größe des Gerätespeichers in Gigabyte zurück. Der Wert ist eine Näherung, die durch Runden auf die nächste Zweierpotenz und anschließendes Teilen durch 1024 ermittelt wird.
-
Gibt das
DevicePosture-Objekt des Browsers zurück. Damit können Entwickler den aktuellen Zustand des Geräts abfragen – also ob der Viewport flach oder gefaltet ist – und auf Zustandsänderungen mit Code reagieren. -
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. Es ist 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 und zum Auflisten angeschlossener HID-Geräte sowie Event-Handler für verbundene HID-Geräte bereitstellt. -
Gibt ein
Ink-Objekt für das aktuelle Dokument zurück, das Zugriff auf die Funktionen der Ink API bietet. -
Gibt ein
Keyboard-Objekt zurück. Es bietet Zugriff auf Funktionen, die Tastaturbelegungen abrufen und die Erfassung von Tastenanschlägen der physischen Tastatur ein- oder ausschalten. -
Gibt einen String zurück, der die bevorzugte Sprache des Benutzers angibt, üblicherweise die Sprache der Browseroberfläche. Ist sie unbekannt, wird
nullzurückgegeben. -
Gibt ein Array von Strings mit den Sprachen des Benutzers in der Reihenfolge seiner Präferenzen zurück.
-
Gibt ein
LockManager-Objekt zurück, das Methoden zum Anfordern eines neuenLock-Objekts und zum Abfragen eines bestehendenLock-Objekts bereitstellt. -
Bietet Zugriff auf das
NavigatorLogin-Objekt des Browsers. Ein föderierter Identitätsanbieter (IdP) kann damit den Anmeldestatus eines Benutzers festlegen, wenn dieser sich beim IdP an- oder abmeldet. Weitere Informationen finden Sie unter Federated Credential Management (FedCM) API. -
Gibt die maximale Anzahl gleichzeitiger Berührungspunkte zurück, die das aktuelle Gerät unterstützt.
-
Gibt ein
MediaCapabilities-Objekt zurück, das Informationen über die Dekodierungs- und Kodierungsfähigkeiten für ein bestimmtes Format sowie über Ausgabefähigkeiten bereitstellen kann. -
Gibt eine Referenz auf ein
MediaDevices-Objekt zurück. Damit lassen sich Informationen über verfügbare Mediengeräte abrufen (MediaDevices.enumerateDevices()), die unterstützten konfigurierbaren Eigenschaften für Medien auf dem Computer des Benutzers und im User Agent ermitteln (MediaDevices.getSupportedConstraints()) sowie überMediaDevices.getUserMedia()der Zugriff auf Medien anfordern. -
Gibt ein
MediaSession-Objekt zurück. Damit können Metadaten bereitgestellt werden, anhand derer der Browser dem Benutzer Informationen über aktuell wiedergegebene Medien anzeigen kann, beispielsweise in einer globalen Oberfläche zur Mediensteuerung. -
Gibt einen booleschen Wert zurück, der angibt, ob der Browser online ist.
-
Gibt
truezurück, wenn der Browser PDF-Dateien beim Aufrufen direkt anzeigen kann, andernfallsfalse. -
Gibt ein
Permissions-Objekt zurück, mit dem sich der Berechtigungsstatus von APIs abfragen und aktualisieren lässt, die von der Permissions API abgedeckt werden. -
Gibt das aktuelle
PreferenceManager-Objekt des Dokuments zurück, das Zugriff auf Informationen zu Benutzereinstellungen 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. Es ist der Einstiegspunkt für die Web Serial API und ermöglicht die Steuerung serieller Schnittstellen. -
Gibt ein
ServiceWorkerContainer-Objekt zurück, das die Registrierung, Entfernung, Aktualisierung und Kommunikation mit denServiceWorker-Objekten für das zugehörige Dokument ermöglicht. -
Gibt das einzige
StorageManager-Objekt zurück. Es dient dazu, Berechtigungen für dauerhafte Speicherung zu verwalten und den verfügbaren Speicherplatz für einzelne Websites oder Anwendungen zu schätzen. -
Gibt ein
USB-Objekt für das aktuelle Dokument zurück, das Zugriff auf die Funktionen der WebUSB API bietet. -
Gibt ein
UserActivation-Objekt mit Informationen über den aktuellen Benutzeraktivierungszustand des Fensters zurück. -
Gibt den User-Agent-String des aktuellen Browsers zurück.
-
Gibt ein
NavigatorUAData-Objekt zurück, das Zugriff auf Informationen über den Browser und das Betriebssystem des Benutzers bietet. -
Gibt eine Referenz auf die
VirtualKeyboard-API zurück, mit der die virtuelle Bildschirmtastatur gesteuert werden kann. -
Gibt eine
WakeLock-Schnittstelle zurück, mit der Sie Bildschirm-Wake-Locks anfordern können. So verhindern Sie, dass der Bildschirm abgedunkelt oder ausgeschaltet wird oder ein Bildschirmschoner erscheint. -
Gibt an, ob der User Agent durch Automatisierung gesteuert wird.
-
Gibt die
WindowControlsOverlay-Schnittstelle zurück. Sie stellt Informationen über die Geometrie der Titelleiste in Desktop-Progressive-Web-Apps sowie ein Ereignis bereit, das bei Änderungen ausgelöst wird. -
Gibt ein
XRSystem-Objekt zurück, das den Einstiegspunkt für die WebXR API darstellt.
Veraltete Eigenschaften
-
Gibt ein Array aller
VRDisplay-Objekte zurück, die derzeit Inhalte darstellen (VRDisplay.isPresentingisttrue). -
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 liefert.
-
Gibt den Wert der Do-Not-Track-Einstellung des Benutzers an. Ist dieser Wert „1“, sollte Ihre Website oder Anwendung den Benutzer nicht nachverfolgen.
-
Gibt ein
MimeTypeArrayzurück, das die vom Browser unterstützten MIME-Typen auflistet. -
Gibt einen String zurück, der das aktuelle Betriebssystem bezeichnet.
-
Gibt einen String zurück, der die Plattform des Browsers bezeichnet. Verlassen Sie sich nicht darauf, dass diese Eigenschaft einen aussagekräftigen Wert liefert.
-
Gibt ein
PluginArrayzurü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.
Nicht standardisierte Eigenschaften
-
Gibt die Build-Kennung des Browsers zurück. In modernen Browsern gibt diese Eigenschaft zum Schutz der Privatsphäre mittlerweile einen festen Zeitstempel zurück, beispielsweise
20181001000000ab Firefox 64. -
Gibt einen booleschen Wert zurück, der angibt, ob ein Benutzer der Weitergabe oder dem Verkauf seiner Informationen zustimmt.
-
Gibt einen booleschen Wert zurück, der angibt, ob der Browser im Standalone-Modus ausgeführt wird. Nur in Apples iOS Safari verfügbar.
Instanzmethoden
Erbt keine Methoden.
-
Gibt
truezurück, wenn ein Aufruf vonNavigator.share()erfolgreich wäre. -
Entfernt ein Badge vom Symbol der aktuellen App und gibt ein
Promisezurück, das mitundefinederfüllt wird. -
Ersetzt bestimmte Strings innerhalb der zugeordneten URL, die einer angegebenen opaken URN oder der internen
url-Eigenschaft einesFencedFrameConfigentspricht. Diese Methode wurde vorübergehend bereitgestellt – daher „deprecated“ –, um solche Ersetzungen für URLs von Fenced Frames zu ermöglichen und Anbietern von Werbetechnologie die Migration bestehender Implementierungen zu den APIs der Privacy Sandbox zu erleichtern. -
Gibt einen Wert zurück, der angibt, ob das angegebene Medienelement, der Audiokontext oder der „Typ“ einer Medienfunktion automatisch wiedergegeben werden darf.
-
Gibt ein Promise zurück, das mit einem
BatteryManager-Objekt erfüllt wird, das Informationen über den Ladezustand des Akkus bereitstellt. -
Gibt ein Array von
Gamepad-Objekten zurück, jeweils eines für jeden mit dem Gerät verbundenen Gamecontroller. -
Gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird. Diese repräsentieren zugehörige native Anwendungen oder Progressive Web Apps, die der Benutzer installiert hat.
-
Ermöglicht es Websites, sich als möglicher Handler für ein bestimmtes Protokoll zu registrieren.
-
Gibt ein
Promisefür ein MediaKeySystemAccess-Objekt zurück. -
Gibt ein
Promisezurück, das eine Anfrage zum Zugriff auf MIDI-Geräte im System des Benutzers repräsentiert. -
Dient dazu, eine kleine Datenmenge asynchron über HTTP vom User Agent an einen Webserver zu übertragen.
-
Setzt ein Badge auf das Symbol der zugehörigen App und gibt ein
Promisezurück, das mitundefinederfüllt wird. -
Ruft den nativen Freigabemechanismus der aktuellen Plattform auf.
-
Löst auf Geräten, die dies unterstützen, eine Vibration aus. Ist keine Vibrationsunterstützung verfügbar, geschieht nichts.
-
Hebt die Registrierung einer Website als Handler für ein bestimmtes Protokoll auf.
Veraltete Methoden
-
Fordert zunächst die Berechtigung des Benutzers an und gibt anschließend den Audio- oder Videostream einer Kamera oder eines Mikrofons am lokalen Computer zurück.
-
Gibt ein Promise zurück, das mit einem Array von
VRDisplay-Objekten erfüllt wird, die verfügbare, mit dem Computer verbundene VR-Geräte repräsentieren. -
Gibt immer
falsezurück. -
Gibt
falsezurück. Die JavaScript-Funktionen für Tainting und Untainting wurden in JavaScript 1.2 entfernt.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-navigator-object> |