JS JavaScript-Referenz

XMLDocument Schnittstelle

Die Schnittstelle <code>XMLDocument</code> steht für ein XML-Dokument. Sie erbt alle Eigenschaften und Methoden von <code>Document</code> und fügt selbst keine Standard-Mitglieder hinzu.

XMLHttpRequest Schnittstelle

Mit <code>XMLHttpRequest</code> sendet man HTTP-Anfragen an einen Server und empfängt die Antworten, ohne die Seite neu zu laden. Die API ist ereignisbasiert.

XMLHttpRequest.abort() Methode

Bricht eine laufende <code>XMLHttpRequest</code>-Anfrage ab, setzt <code>readyState</code> auf <code>0</code> (UNSENT) und <code>status</code> auf <code>0</code>.

XMLHttpRequest.getAllResponseHeaders() Methode

Gibt alle Antwort-Header einer <code>XMLHttpRequest</code>-Anfrage als einen String zurück, jede Zeile durch CRLF (<code>\r\n</code>) getrennt.

XMLHttpRequest.getResponseHeader() Methode

Liefert den Wert eines bestimmten HTTP-Antwort-Headers als String oder <code>null</code>, wenn der Header fehlt oder nicht lesbar ist.

XMLHttpRequest.open() Methode

Initialisiert eine neu erstellte <code>XMLHttpRequest</code>-Anfrage oder initialisiert eine bestehende neu. Dabei werden HTTP-Methode, Ziel-URL und Modus (asynchron/synchron) festgelegt.

XMLHttpRequest.overrideMimeType() Methode

Überschreibt den vom Server gelieferten MIME-Typ der Antwort, damit der Browser die empfangenen Daten mit dem angegebenen Typ (und ggf. Zeichensatz) interpretiert.

XMLHttpRequest.readyState Eigenschaft

Nur lesbare Eigenschaft, die den aktuellen Zustand einer <code>XMLHttpRequest</code>-Anfrage als Zahl von <code>0</code> bis <code>4</code> angibt.

XMLHttpRequest.response Eigenschaft

Liefert den Antwortkörper einer XHR-Anfrage als <code>ArrayBuffer</code>, <code>Blob</code>, <code>Document</code>, Objekt (JSON) oder String – abhängig von <code>responseType</code>.

XMLHttpRequest.responseText Eigenschaft

Schreibgeschützte Eigenschaft, die den vom Server empfangenen Antwortkörper als <code>string</code> liefert – auch schon teilweise, während die Übertragung noch läuft.

XMLHttpRequest.responseType Eigenschaft

Legt fest, in welchem Format <code>XMLHttpRequest.response</code> die Antwortdaten liefert, etwa als Text, JSON, <code>Blob</code>, <code>ArrayBuffer</code> oder <code>Document</code>.

XMLHttpRequest.responseURL Eigenschaft

Schreibgeschützte Eigenschaft mit der endgültigen, serialisierten URL der Antwort, auch nach Weiterleitungen. Ist die URL null, ergibt sie einen leeren String.

XMLHttpRequest.responseXML Eigenschaft

Schreibgeschützte Eigenschaft, die die Antwort einer XHR-Anfrage als geparstes <code>Document</code> (XML oder HTML) liefert oder <code>null</code>, wenn keine gültige Antwort vorliegt.

XMLHttpRequest.send() Methode

Sendet die zuvor mit <code>open()</code> vorbereitete HTTP-Anfrage an den Server, optional mit einem Anfragekörper.

XMLHttpRequest.setAttributionReporting() Methode

Markiert eine XHR-Anfrage so, dass ihre Antwort eine Attributionsquelle oder einen Attributionstrigger der Attribution Reporting API registrieren darf.

XMLHttpRequest.setPrivateToken() Methode

Hängt an einen <code>XMLHttpRequest</code> Informationen zu einem privaten Status-Token an, damit dieser Token ausgibt, einlöst oder einen Einlösungsnachweis mitsendet.

XMLHttpRequest.setRequestHeader() Methode

Setzt den Wert eines HTTP-Anforderungsheaders für eine <code>XMLHttpRequest</code>-Anfrage. Aufruf nur zwischen <code>open()</code> und <code>send()</code>.

XMLHttpRequest.status Eigenschaft

Schreibgeschützte Eigenschaft, die den numerischen HTTP-Statuscode der Antwort eines <code>XMLHttpRequest</code> liefert (z. B. <code>200</code> oder <code>404</code>).

XMLHttpRequest.statusText Eigenschaft

Schreibgeschützte Eigenschaft, die die textuelle Statusnachricht der HTTP-Antwort liefert, z. B. <code>"OK"</code> oder <code>"Not Found"</code>.

XMLHttpRequest.timeout Eigenschaft

Legt in Millisekunden fest, wie lange eine <code>XMLHttpRequest</code>-Anfrage maximal dauern darf, bevor sie automatisch abgebrochen wird. <code>0</code> bedeutet: kein Zeitlimit.

XMLHttpRequest.upload Eigenschaft

Liefert ein <code>XMLHttpRequestUpload</code>-Objekt, über dessen Events sich der Fortschritt beim Hochladen des Request-Bodys verfolgen lässt.

XMLHttpRequest.withCredentials Eigenschaft

Boolescher Wert, der festlegt, ob ein Cross-Origin-Request per <code>XMLHttpRequest</code> Anmeldeinformationen wie Cookies, HTTP-Authentifizierung oder TLS-Client-Zertifikate mitsendet.

XMLHttpRequest: readystatechange Ereignis

Wird ausgelöst, sobald sich die Eigenschaft <code>readyState</code> eines <code>XMLHttpRequest</code> ändert.

XMLHttpRequestEventTarget Schnittstelle

Abstraktes Interface, das die gemeinsamen Fortschritts-Ereignis-Handler (<code>onload</code>, <code>onprogress</code>, <code>onerror</code> …) für <code>XMLHttpRequest</code> und <code>XMLHttpRequestUpload</code> bereitstellt.

XMLHttpRequestEventTarget: abort Ereignis

Wird ausgelöst, wenn eine XHR-Anfrage abgebrochen wurde, zum Beispiel durch einen Aufruf von <code>XMLHttpRequest.abort()</code>.

XMLHttpRequestEventTarget: error Ereignis

Wird an einem <code>XMLHttpRequest</code> oder <code>XMLHttpRequestUpload</code> ausgelöst, wenn die Anfrage auf Netzwerkebene fehlschlägt.

XMLHttpRequestEventTarget: load Ereignis

Das <code>load</code>-Ereignis wird ausgelöst, wenn eine <code>XMLHttpRequest</code>-Transaktion erfolgreich abgeschlossen wurde, also eine Antwort vollständig empfangen ist.

XMLHttpRequestEventTarget: loadend Ereignis

Wird ausgelöst, wenn eine XHR-Anfrage beendet ist – egal ob erfolgreich (nach <code>load</code>) oder nicht (nach <code>abort</code>, <code>error</code> oder <code>timeout</code>).

XMLHttpRequestEventTarget: loadstart Ereignis

Das <code>loadstart</code>-Ereignis wird ausgelöst, sobald eine XMLHttpRequest-Anfrage oder ihr Upload beginnt, Daten zu übertragen.

XMLHttpRequestEventTarget: progress Ereignis

Wird während einer laufenden <code>XMLHttpRequest</code>-Übertragung wiederholt ausgelöst, sobald neue Daten empfangen (oder beim Upload gesendet) wurden.

XMLHttpRequestEventTarget: timeout Ereignis

Wird ausgelöst, wenn eine <code>XMLHttpRequest</code>-Anfrage abgebrochen wird, weil die in <code>xhr.timeout</code> festgelegte Zeit abgelaufen ist.

XMLHttpRequestUpload Schnittstelle

Stellt den Upload-Vorgang eines <code>XMLHttpRequest</code> dar und liefert Fortschritts-Events für die gesendeten Daten, z. B. für Upload-Fortschrittsbalken.

XMLSerializer Schnittstelle

Wandelt einen DOM-Baum oder einzelnen Knoten mit <code>serializeToString()</code> in einen XML-String um.

XMLSerializer.serializeToString() Methode

Wandelt einen DOM-Knoten samt Unterbaum in eine XML-Zeichenkette um – etwa um SVG, XML-Dokumente oder Fragmente zu speichern oder zu versenden.

XPathEvaluator Schnittstelle

Das <code>XPathEvaluator</code>-Interface kompiliert und wertet XPath-1.0-Ausdrücke gegen HTML- oder XML-Dokumente aus.

XPathEvaluator.createExpression() Methode

Kompiliert einen XPath-Ausdruck zu einem <code>XPathExpression</code>-Objekt, das sich beliebig oft und effizient gegen verschiedene Kontextknoten auswerten lässt.

XPathEvaluator.createNSResolver() Methode

Veraltete Methode, die früher einen <code>XPathNSResolver</code> aus einem Knoten erzeugte. Heute gibt sie den übergebenen Knoten unverändert zurück.

XPathEvaluator.evaluate() Methode

Führt einen XPath-Ausdruck auf einem Knoten oder Dokument aus und gibt das Ergebnis als <code>XPathResult</code> zurück.

XPathExpression Schnittstelle

Ein vorkompilierter XPath-Ausdruck, der mit <code>evaluate()</code> wiederholt auf ein Dokument oder einen beliebigen Knoten angewendet werden kann.

XPathExpression.evaluate() Methode

Führt einen vorkompilierten XPath-Ausdruck relativ zu einem Kontextknoten aus und gibt ein <code>XPathResult</code> zurück.

XPathResult Schnittstelle

Repräsentiert das Ergebnis einer XPath-Auswertung per <code>document.evaluate()</code> – als Zahl, Zeichenkette, Boolean, einzelner Knoten oder Knotenmenge.

XPathResult.booleanValue Eigenschaft

Gibt den booleschen Wert eines XPath-Ergebnisses zurück, dessen <code>resultType</code> <code>XPathResult.BOOLEAN_TYPE</code> ist (schreibgeschützt).

XPathResult.invalidIteratorState Eigenschaft

Schreibgeschützter boolescher Wert: <code>true</code>, wenn das Dokument nach der XPath-Auswertung verändert wurde und der Iterator eines Iterator-Ergebnisses dadurch ungültig ist.

XPathResult.iterateNext() Methode

Gibt den nächsten Knoten eines iterierbaren XPath-Ergebnisses zurück oder <code>null</code>, wenn keine weiteren Knoten vorhanden sind.

XPathResult.numberValue Eigenschaft

Schreibgeschützte Eigenschaft, die den Zahlenwert eines XPath-Ergebnisses liefert, wenn <code>resultType</code> gleich <code>XPathResult.NUMBER_TYPE</code> ist.

XPathResult.resultType Eigenschaft

Schreibgeschützte Eigenschaft, die als Zahl angibt, welchen Ergebnistyp ein <code>XPathResult</code> hat (z. B. <code>NUMBER_TYPE</code> oder <code>ORDERED_NODE_SNAPSHOT_TYPE</code>).

XPathResult.singleNodeValue Eigenschaft

Liefert den gefundenen <code>Node</code> eines XPath-Ergebnisses vom Typ <code>ANY_UNORDERED_NODE_TYPE</code> oder <code>FIRST_ORDERED_NODE_TYPE</code> bzw. <code>null</code>, wenn nichts passt.

XPathResult.snapshotItem() Methode

Gibt den Knoten an Position <code>index</code> aus einem Snapshot-Ergebnis von <code>document.evaluate()</code> zurück oder <code>null</code>, wenn der Index außerhalb des Bereichs liegt.

XPathResult.snapshotLength Eigenschaft

Schreibgeschützte Eigenschaft, die die Anzahl der Knoten in einem XPath-Ergebnis-Snapshot als Ganzzahl liefert.

XPathResult.stringValue Eigenschaft

Schreibgeschützte Eigenschaft, die den Zeichenkettenwert eines XPath-Ergebnisses liefert, wenn <code>resultType</code> gleich <code>STRING_TYPE</code> ist.

XRAnchor Schnittstelle

Ein <code>XRAnchor</code> steht für einen Punkt, der relativ zur realen Welt fixiert ist. Das System verfolgt seine Pose über die Zeit und korrigiert sie bei Bedarf.

XRAnchor.anchorSpace Eigenschaft

Schreibgeschützte Eigenschaft, die ein <code>XRSpace</code> liefert, mit dem sich die Pose des Ankers relativ zu anderen Räumen (z. B. dem Referenzraum) bestimmen lässt.

XRAnchor.delete() Methode

Entfernt einen <code>XRAnchor</code> aus der XR-Sitzung. Danach verfolgt das System seine Pose nicht mehr und er taucht nicht mehr in <code>XRFrame.trackedAnchors</code> auf.

XRAnchorSet Schnittstelle

Die schreibgeschützte, Set-ähnliche Sammlung aller <code>XRAnchor</code>-Objekte, die im aktuellen <code>XRFrame</code> verfolgt werden. Du erreichst sie über <code>XRFrame.trackedAnchors</code>.

XRBoundedReferenceSpace Schnittstelle

Beschreibt einen WebXR-Referenzraum vom Typ <code>bounded-floor</code>, dessen begehbare Fläche durch ein Polygon am Boden (<code>boundsGeometry</code>) begrenzt ist.

XRBoundedReferenceSpace.boundsGeometry Eigenschaft

Schreibgeschütztes Array von <code>DOMPointReadOnly</code>-Punkten, die das Bodenpolygon beschreiben, in dem sich der Nutzer in einer <code>bounded-floor</code>-Sitzung sicher bewegen kann.

XRCompositionLayer Schnittstelle

Abstrakte Basisschnittstelle der WebXR Layers API mit gemeinsamen Eigenschaften (z. B. <code>layout</code>, <code>needsRedraw</code>) und der Methode <code>destroy()</code> für alle Kompositions-Layer.

XRCompositionLayer.blendTextureSourceAlpha Eigenschaft

Boolean, der festlegt, ob der XR-Compositor den Alpha-Kanal der Layer-Textur beim Überblenden berücksichtigt (<code>true</code>) oder den Layer als deckend behandelt (<code>false</code>).

XRCompositionLayer.destroy() Methode

Gibt die Grafikressourcen einer Composition-Ebene frei, zum Beispiel WebGL-Texturen. Danach lässt sich die Ebene nicht mehr zum Rendern nutzen.

XRCompositionLayer.layout Eigenschaft

Schreibgeschützte Eigenschaft, die den Layout-Typ einer WebXR-Kompositionsebene angibt, z. B. <code>"mono"</code>, <code>"stereo"</code> oder <code>"stereo-top-bottom"</code>.

XRCompositionLayer.mipLevels Eigenschaft

Schreibgeschützte Zahl, die angibt, wie viele Mip-Levels die Farb- und Texturdaten einer WebXR-Kompositionsebene haben.

XRCompositionLayer.needsRedraw Eigenschaft

Schreibgeschützter boolescher Wert. Er zeigt an, dass der Inhalt einer WebXR-Kompositionsebene verloren ging und im nächsten Frame neu gezeichnet werden muss.

XRCPUDepthInformation Schnittstelle

Liefert CPU-zugängliche Tiefendaten einer WebXR-Ansicht, die <code>XRFrame.getDepthInformation()</code> in einer Sitzung mit <code>"cpu-optimized"</code>-Tiefenerkennung zurückgibt.

XRCPUDepthInformation.data Eigenschaft

Schreibgeschützter <code>ArrayBuffer</code> mit den rohen Tiefenwerten des aktuellen WebXR-Frames, die auf der CPU ausgelesen werden.

XRCPUDepthInformation.getDepthInMeters() Methode

Gibt die Entfernung in Metern am Punkt (<code>x</code>, <code>y</code>) in normalisierten Ansichtskoordinaten zurück. Der Ursprung liegt oben links.

XRCubeLayer Schnittstelle

Kompositionsebene der WebXR Layers API. Der XR-Compositor legt eine Cube-Map mit sechs Flächen als unendlich ferne Umgebung um den Betrachter, zum Beispiel als Skybox.

XRCubeLayer.orientation Eigenschaft

Liest oder setzt die Ausrichtung einer <code>XRCubeLayer</code> als Einheitsquaternion (<code>DOMPointReadOnly</code>) relativ zum Referenzraum in <code>space</code>.

XRCubeLayer.space Eigenschaft

Liest oder setzt den <code>XRSpace</code>, der festlegt, wie die Würfel-Ebene (z. B. eine Skybox) relativ zur physischen Umgebung des Nutzers ausgerichtet ist.

XRCubeLayer: redraw Ereignis

Wird an ein <code>XRCubeLayer</code> gesendet, wenn seine Ressourcen verloren gehen oder der XR-Kompositor den Layer nicht mehr reprojizieren kann. Der Layer muss dann neu gezeichnet werden.

XRCylinderLayer Schnittstelle

Eine WebXR-Kompositionsschicht, die Inhalte auf einem gebogenen, zylinderförmigen Rechteck im Raum darstellt – gut geeignet für Menüs, Videos und Textpanels.

XRCylinderLayer.aspectRatio Eigenschaft

Gibt das Seitenverhältnis (Breite zu Höhe) des sichtbaren Zylinderabschnitts eines <code>XRCylinderLayer</code> an oder setzt es.

XRCylinderLayer.centralAngle Eigenschaft

Gibt an, wie weit der sichtbare Abschnitt eines <code>XRCylinderLayer</code> um die Zylinderachse reicht. Der Winkel wird in Bogenmaß angegeben und lässt sich lesen und setzen.

XRCylinderLayer.radius Eigenschaft

Gibt den Radius des Zylinders einer <code>XRCylinderLayer</code> in Metern an oder legt ihn fest. Der Wert ist les- und schreibbar.

XRCylinderLayer.space Eigenschaft

Legt über einen <code>XRSpace</code> fest, in welchem Referenzraum eine zylindrische XR-Ebene liegt und wie sie sich relativ zur physischen Umgebung verhält.

XRCylinderLayer.transform Eigenschaft

Liefert oder setzt ein <code>XRRigidTransform</code>, das Position und Ausrichtung der Zylinder-Ebene relativ zu ihrem <code>space</code> festlegt.

XRCylinderLayer: redraw Ereignis

Wird an ein <code>XRCylinderLayer</code> gesendet, wenn seine Ressourcen verloren gehen oder der XR-Compositor die Ebene nicht mehr neu projizieren kann. Der Inhalt muss dann neu gezeichnet werden.

XRDepthInformation Schnittstelle

Basis-Interface der WebXR-Tiefenerkennung: beschreibt Größe, Koordinatentransformation und Skalierung eines Tiefenpuffers, der die Entfernung zur realen Umgebung angibt.

XRDepthInformation.height Eigenschaft

Schreibgeschützte Ganzzahl mit der Höhe des Tiefenpuffers in Pixeln, also der Anzahl der Zeilen der Tiefenkarte.

XRDepthInformation.normDepthBufferFromNormView Eigenschaft

Schreibgeschütztes <code>XRRigidTransform</code>, das normalisierte View-Koordinaten in normalisierte Koordinaten des Tiefenpuffers umrechnet.

XRDepthInformation.rawValueToMeters Eigenschaft

Schreibgeschützter Skalierungsfaktor, mit dem rohe Werte aus dem Tiefenpuffer multipliziert werden, um Abstände in Metern zu erhalten.

XRDepthInformation.width Eigenschaft

Schreibgeschützte Eigenschaft, die die Breite des Tiefenpuffers einer WebXR-Tiefenmessung in Pixeln (Anzahl der Spalten) als <code>unsigned long</code> liefert.

XREquirectLayer Schnittstelle

WebXR-Kompositionsschicht, die eine equirektanguläre Textur (360°- oder 180°-Panorama) direkt im Kompositor auf die Innenseite einer Kugel oder eines Kugelausschnitts abbildet.

XREquirectLayer.centralHorizontalAngle Eigenschaft

Liest oder setzt den zentralen horizontalen Winkel (in Radiant), über den ein <code>XREquirectLayer</code> sein equirektanguläres Bild auf die Kugel abbildet.

XREquirectLayer.lowerVerticalAngle Eigenschaft

Legt den unteren vertikalen Winkel (in Radiant) fest, bis zu dem eine äquirektangulare Textur auf die Kugel einer <code>XREquirectLayer</code> abgebildet wird. Die Eigenschaft ist les- und schreibbar.

XREquirectLayer.radius Eigenschaft

Liest oder setzt den Radius (in Metern) der Kugel, auf die eine <code>XREquirectLayer</code> ihr equirektangulares Bild projiziert; <code>0</code> steht für eine unendlich große Kugel.

XREquirectLayer.space Eigenschaft

Liest oder setzt den <code>XRSpace</code>, der die räumliche Beziehung eines äquirektangulären Layers zur physischen Umgebung des Nutzers festlegt.

XREquirectLayer.transform Eigenschaft

Legt als <code>XRRigidTransform</code> Position und Ausrichtung einer equirektangulären Ebene relativ zu ihrem Referenzraum (<code>space</code>) fest.

XREquirectLayer.upperVerticalAngle Eigenschaft

Gibt den oberen vertikalen Winkel (in Bogenmaß) des Kugelausschnitts an, auf den eine <code>XREquirectLayer</code> ihre equirektangulare Textur abbildet, oder setzt ihn.

XREquirectLayer: redraw Ereignis

Wird an ein <code>XREquirectLayer</code> gesendet, wenn dessen Ressourcen verloren gehen oder der XR-Kompositor den Inhalt nicht mehr neu projizieren kann – der Inhalt muss neu gezeichnet werden.

XRFrame Schnittstelle

Ein <code>XRFrame</code> ist eine Momentaufnahme des Tracking-Zustands einer <code>XRSession</code> und wird an den Callback von <code>XRSession.requestAnimationFrame()</code> übergeben.

XRFrame.createAnchor() Methode

Erzeugt asynchron einen frei platzierten <code>XRAnchor</code>, der eine Pose relativ zur realen Welt festhält, auch wenn das System sein Weltverständnis aktualisiert.

XRFrame.fillJointRadii() Methode

Schreibt die Radien mehrerer Handgelenk-Räume (<code>XRJointSpace</code>) in ein <code>Float32Array</code> und gibt <code>true</code> zurück, wenn alle Radien ermittelt werden konnten.

XRFrame.fillPoses() Methode

Schreibt die 4×4-Posenmatrizen mehrerer <code>XRSpace</code>-Objekte relativ zu einem Basisraum in ein <code>Float32Array</code> und liefert <code>true</code>, wenn alle Posen ermittelt werden konnten.

XRFrame.getDepthInformation() Methode

Liefert für eine <code>XRView</code> des aktuellen Frames ein <code>XRCPUDepthInformation</code>-Objekt mit Tiefendaten der realen Umgebung, die auf der CPU gelesen werden können.

XRFrame.getHitTestResults() Methode

Gibt für den aktuellen XR-Frame ein Array von <code>XRHitTestResult</code>-Objekten zurück, also die Schnittpunkte des Strahls einer <code>XRHitTestSource</code> mit realen Oberflächen.

XRFrame.getHitTestResultsForTransientInput() Methode

Liefert für den aktuellen Frame ein Array von <code>XRTransientInputHitTestResult</code>-Objekten zu einer <code>XRTransientInputHitTestSource</code>, also Treffer für kurzlebige Eingaben wie Bildschirm-Taps.

XRFrame.getJointPose() Methode

Gibt ein <code>XRJointPose</code>-Objekt mit Position, Ausrichtung und Radius eines Handgelenkpunkts (<code>XRJointSpace</code>) relativ zu einem Basisraum zurück – oder <code>null</code>.

XRFrame.getLightEstimate() Methode

Gibt für eine <code>XRLightProbe</code> ein <code>XRLightEstimate</code> mit geschätzter Umgebungsbeleuchtung des aktuellen Frames zurück, oder <code>null</code>.

XRFrame.getPose() Methode

Gibt die Pose (Position und Orientierung) eines <code>XRSpace</code> relativ zu einem Basis-Raum als <code>XRPose</code> zurück, oder <code>null</code>, wenn sie nicht ermittelbar ist.

XRFrame.getViewerPose() Methode

Gibt ein <code>XRViewerPose</code> zurück, das Position und Ausrichtung des Betrachters relativ zum angegebenen Referenzraum beschreibt – oder <code>null</code>, wenn keine Pose ermittelt werden kann.

XRFrame.session Eigenschaft

Die schreibgeschützte Eigenschaft <code>session</code> liefert das <code>XRSession</code>-Objekt, zu dem der aktuelle <code>XRFrame</code> gehört.

XRFrame.trackedAnchors Eigenschaft

Schreibgeschützte Eigenschaft, die ein <code>XRAnchorSet</code> mit allen Ankern liefert, die das XR-System im aktuellen Frame noch verfolgt.

XRHand Schnittstelle

Nur lesbare, geordnete Map mit den 25 Handgelenken einer getrackten Hand: Schlüssel ist der Gelenkname, Wert der zugehörige <code>XRJointSpace</code>.

XRHitTestResult Schnittstelle

Ein einzelnes Ergebnis eines WebXR-Treffer-Tests, also ein Schnittpunkt eines Strahls mit einer realen Oberfläche, dessen Pose über <code>getPose()</code> abgefragt wird.

XRHitTestResult.createAnchor() Methode

Erstellt aus einem Hit-Test-Treffer asynchron einen <code>XRAnchor</code>, der an der getroffenen realen Oberfläche verankert bleibt und vom System fortlaufend nachgeführt wird.

XRHitTestResult.getPose() Methode

Liefert die <code>XRPose</code> eines Treffertest-Ergebnisses (Schnittpunkt mit realer Geometrie) relativ zum angegebenen Referenzraum oder <code>null</code>.

XRHitTestSource Schnittstelle

Steht für ein aktives Hit-Test-Abonnement in einer WebXR-AR-Sitzung. Die Ergebnisse liefert <code>XRFrame.getHitTestResults()</code> in jedem Frame.

XRHitTestSource.cancel() Methode

Beendet die Anmeldung für einen Hit-Test: Die <code>XRHitTestSource</code> liefert danach keine Ergebnisse mehr und gibt ihre Ressourcen frei.

XRInputSource Schnittstelle

Beschreibt eine einzelne Eingabequelle einer WebXR-Sitzung, z. B. einen Handcontroller, eine getrackte Hand, Blickrichtung oder einen Touchscreen-Tipp.

XRInputSource.gamepad Eigenschaft

Liefert ein <code>Gamepad</code>-Objekt mit dem aktuellen Zustand der Tasten und Achsen eines XR-Controllers oder <code>null</code>, wenn die Eingabequelle keine solchen Bedienelemente hat.

XRInputSource.gripSpace Eigenschaft

Liefert ein <code>XRSpace</code>, dessen Ursprung der Pose der greifenden Hand bzw. des Controllers folgt, oder <code>null</code>, wenn das Eingabegerät nicht gehalten werden kann.

XRInputSource.hand Eigenschaft

Die schreibgeschützte Eigenschaft <code>hand</code> liefert ein <code>XRHand</code>-Objekt mit den Gelenken einer getrackten Hand oder <code>null</code>, wenn die Eingabequelle keine Hand ist.

XRInputSource.handedness Eigenschaft

Schreibgeschützter String (<code>"left"</code>, <code>"right"</code> oder <code>"none"</code>), der angibt, welcher Hand eine WebXR-Eingabequelle zugeordnet ist.

XRInputSource.profiles Eigenschaft

Schreibgeschütztes Array von Profil-Strings, die das Eingabegerät einer <code>XRInputSource</code> von spezifisch bis generisch beschreiben.

XRInputSource.targetRayMode Eigenschaft

Schreibgeschützter String, der angibt, wie der Zielstrahl einer XR-Eingabequelle entsteht: <code>"gaze"</code>, <code>"tracked-pointer"</code>, <code>"screen"</code> oder <code>"transient-pointer"</code>.

XRInputSource.targetRaySpace Eigenschaft

Schreibgeschützte Eigenschaft, die ein <code>XRSpace</code> liefert, dessen Ursprung und Ausrichtung den Zielstrahl (Zeigestrahl) der Eingabequelle beschreiben.

XRInputSourceArray Schnittstelle

Eine dynamische, iterierbare Liste aller <code>XRInputSource</code>-Objekte, die gerade mit einer WebXR-Sitzung verbunden sind. Man erhält sie über <code>XRSession.inputSources</code>.

XRInputSourceArray.entries() Methode

Gibt einen Iterator über <code>[index, XRInputSource]</code>-Paare aller aktuell verbundenen Eingabequellen einer WebXR-Sitzung zurück.

XRInputSourceArray.forEach() Methode

Führt einen Callback einmal für jede <code>XRInputSource</code> im <code>XRInputSourceArray</code> aus, in Index-Reihenfolge von 0 bis zum Ende.

XRInputSourceArray.keys() Methode

Gibt einen Iterator über die Indizes (<code>0</code> bis <code>length - 1</code>) aller Eingabequellen in einem <code>XRInputSourceArray</code> zurück.

XRInputSourceArray.length Eigenschaft

Schreibgeschützte Ganzzahl mit der Anzahl der aktuell verbundenen XR-Eingabequellen (Controller, Hände, Blick) in einem <code>XRInputSourceArray</code>.

XRInputSourceArray.values() Methode

Gibt einen Iterator zurück, der alle <code>XRInputSource</code>-Objekte eines <code>XRInputSourceArray</code> der Reihe nach liefert.

XRInputSourceEvent Schnittstelle

Ereignis der WebXR Device API, das eine Aktion an einem XR-Eingabegerät meldet, etwa einen Controller-Trigger, einen Griff oder eine Pinch-Geste.

XRInputSourceEvent.frame Eigenschaft

Schreibgeschützte Eigenschaft, die das <code>XRFrame</code> liefert, in dem das WebXR-Eingabeereignis (z. B. <code>select</code> oder <code>squeeze</code>) aufgetreten ist.

XRInputSourceEvent.inputSource Eigenschaft

Die schreibgeschützte Eigenschaft <code>inputSource</code> liefert das <code>XRInputSource</code>-Objekt des Eingabegeräts (Controller, Hand, Blick), das das Ereignis ausgelöst hat.

XRInputSourcesChangeEvent Schnittstelle

Ereignisobjekt für <code>inputsourceschange</code> an einer <code>XRSession</code>: meldet, welche XR-Eingabequellen (Controller, Hände, Blick) hinzugekommen oder weggefallen sind.

XRInputSourcesChangeEvent.added Eigenschaft

Schreibgeschütztes Array mit den <code>XRInputSource</code>-Objekten, die seit dem letzten <code>inputsourceschange</code>-Ereignis neu verfügbar geworden sind.

XRInputSourcesChangeEvent.removed Eigenschaft

Schreibgeschütztes, eingefrorenes Array der <code>XRInputSource</code>-Objekte, die seit dem letzten <code>inputsourceschange</code>-Ereignis aus der <code>XRSession</code> entfernt wurden.

XRInputSourcesChangeEvent.session Eigenschaft

Schreibgeschützte Eigenschaft, die die <code>XRSession</code> liefert, deren Liste der Eingabequellen (Controller, Hände, Blick) sich geändert hat.

XRJointPose Schnittstelle

Ein <code>XRPose</code> für ein Handgelenk (Knochen/Fingerglied) beim WebXR-Hand-Tracking, ergänzt um den Radius des Gelenks in Metern.

XRJointPose.radius Eigenschaft

Schreibgeschützte Eigenschaft, die den Radius eines Handgelenks in Metern angibt, also den Abstand vom Gelenkmittelpunkt bis zur Hautoberfläche.

XRJointSpace Schnittstelle

Ein <code>XRSpace</code>, der Position und Ausrichtung eines einzelnen Handgelenks bzw. Fingergelenks einer <code>XRHand</code> beschreibt.

XRJointSpace.jointName Eigenschaft

Schreibgeschützte Eigenschaft, die den Namen des Handgelenks (z. B. <code>"wrist"</code> oder <code>"index-finger-tip"</code>) liefert, das dieser <code>XRJointSpace</code> verfolgt.

XRLayer Schnittstelle

Abstrakte Basisschnittstelle der WebXR Device API, von der alle Schichttypen wie <code>XRWebGLLayer</code> und <code>XRCompositionLayer</code> erben.

XRLayerEvent Schnittstelle

Ereignistyp der WebXR Layers API, der bei Zustandsänderungen einer <code>XRLayer</code> ausgelöst wird, vor allem beim <code>redraw</code>-Ereignis, wenn der Inhalt einer Ebene neu gezeichnet werden muss.

XRLayerEvent.layer Eigenschaft

Die schreibgeschützte Eigenschaft <code>layer</code> von <code>XRLayerEvent</code> verweist auf die <code>XRLayer</code>-Instanz, die das Ereignis ausgelöst hat.

XRLightEstimate Schnittstelle

Liefert die geschätzten Lichtwerte (Hauptlichtrichtung, -intensität und sphärische Harmonische) einer <code>XRLightProbe</code> für ein bestimmtes <code>XRFrame</code>.

XRLightEstimate.primaryLightDirection Eigenschaft

Schreibgeschützter <code>DOMPointReadOnly</code> mit der normierten Richtung vom <code>probeSpace</code> einer <code>XRLightProbe</code> zur hellsten Lichtquelle der realen Umgebung.

XRLightEstimate.primaryLightIntensity Eigenschaft

Liefert ein schreibgeschütztes <code>DOMPointReadOnly</code> mit der RGB-Intensität der primären (hellsten) Lichtquelle, die im <code>probeSpace</code> einer <code>XRLightProbe</code> geschätzt wurde.

XRLightEstimate.sphericalHarmonicsCoefficients Eigenschaft

Schreibgeschütztes <code>Float32Array</code> mit 9 RGB-Kugelflächenfunktions-Koeffizienten (27 Werte), die das geschätzte Umgebungslicht einer AR-Szene beschreiben.

XRLightProbe Schnittstelle

Stellt in einer WebXR-AR-Sitzung eine Lichtsonde dar, die Beleuchtungsinformationen (Lichtschätzung, Reflexions-Cubemap) der realen Umgebung liefert.

XRLightProbe.probeSpace Eigenschaft

Schreibgeschützte Eigenschaft, die ein <code>XRSpace</code> liefert, dessen Position und Orientierung das Bezugssystem der Lichtschätzung eines <code>XRLightProbe</code> bilden.

XRLightProbe: reflectionchange Ereignis

Wird an einem <code>XRLightProbe</code> ausgelöst, sobald die WebXR-Laufzeit eine neue geschätzte Reflexions-Würfelkarte der realen Umgebung bereitstellt.

XRMediaBinding Schnittstelle

Erzeugt WebXR-Kompositionsebenen (Quad, Zylinder, Equirect), die den Inhalt eines <code>HTMLVideoElement</code> direkt in einer immersiven XR-Sitzung anzeigen.

XRMediaBinding.createCylinderLayer() Methode

Erzeugt einen <code>XRCylinderLayer</code>, der ein <code>HTMLVideoElement</code> auf einer gekrümmten, zylinderförmigen Fläche in der XR-Szene darstellt.

XRMediaBinding.createEquirectLayer() Methode

Erzeugt ein <code>XREquirectLayer</code>, das ein equirectangulares Video (z. B. 360°-Video) auf die Innenseite einer Kugel um den Betrachter abbildet.

XRMediaBinding.createQuadLayer() Methode

Erzeugt aus einem <code>HTMLVideoElement</code> eine <code>XRQuadLayer</code>, die das Video auf einer flachen, rechteckigen Fläche im virtuellen Raum darstellt.

XRPose Schnittstelle

Beschreibt Position und Orientierung eines <code>XRSpace</code> relativ zu einem anderen Referenzraum, inklusive optionaler Geschwindigkeiten und einem Hinweis, ob die Werte nur geschätzt sind.

XRPose.angularVelocity Eigenschaft

Schreibgeschützte Eigenschaft, die die Winkelgeschwindigkeit einer Pose in Radiant pro Sekunde relativ zum Basis-<code>XRSpace</code> als <code>DOMPointReadOnly</code> liefert, oder <code>null</code>.

XRPose.emulatedPosition Eigenschaft

Schreibgeschützter Boolean, der angibt, ob die Position in <code>XRPose.transform</code> nur geschätzt oder simuliert ist, statt direkt vom Tracking des XR-Geräts zu stammen.

XRPose.linearVelocity Eigenschaft

Schreibgeschützter <code>DOMPointReadOnly</code> mit der linearen Geschwindigkeit der Pose in Metern pro Sekunde, bezogen auf den Basis-<code>XRSpace</code>, oder <code>null</code>.

XRPose.transform Eigenschaft

Schreibgeschütztes <code>XRRigidTransform</code>, das Position und Orientierung einer Pose relativ zum Basis-<code>XRSpace</code> angibt.

XRProjectionLayer Schnittstelle

Eine WebXR-Kompositionsebene, die die gesamte Sicht des Betrachters ausfüllt und nahezu mit der nativen Bildrate des XR-Geräts neu gezeichnet wird.

XRProjectionLayer.fixedFoveation Eigenschaft

Zahl zwischen <code>0</code> und <code>1</code>, die festlegt, wie stark der XR-Compositor die Randbereiche einer Projektionsebene mit reduzierter Auflösung darstellt (Fixed Foveated Rendering).

XRProjectionLayer.ignoreDepthValues Eigenschaft

Schreibgeschützter Boolean, der angibt, ob der XR-Kompositor die Tiefenpuffer-Werte einer <code>XRProjectionLayer</code> bei der Darstellung ignoriert.

XRProjectionLayer.textureArrayLength Eigenschaft

Schreibgeschützte Zahl, die angibt, wie viele Schichten (Layer) die Array-Textur eines <code>XRProjectionLayer</code> mit <code>textureType: "texture-array"</code> besitzt.

XRProjectionLayer.textureHeight Eigenschaft

Schreibgeschützte Eigenschaft, die die Höhe der Farbtexturen einer <code>XRProjectionLayer</code> in Pixeln als Ganzzahl liefert.

XRProjectionLayer.textureWidth Eigenschaft

Gibt die Breite der Farbtexturen einer <code>XRProjectionLayer</code> in Pixeln an (schreibgeschützt).

XRQuadLayer Schnittstelle

Kompositionsebene der WebXR Layers API, die einen flachen, rechteckigen Bereich im Raum zeigt, etwa für Text, Bedienoberflächen oder Videos.

XRQuadLayer.height Eigenschaft

Die Eigenschaft <code>height</code> von <code>XRQuadLayer</code> gibt die Höhe der rechteckigen Ebene im virtuellen Raum in Metern an. Sie ist les- und schreibbar.

XRQuadLayer.space Eigenschaft

Lesbare und schreibbare Eigenschaft mit dem <code>XRSpace</code>, in dem die Position und Ausrichtung eines <code>XRQuadLayer</code> in der physischen Umgebung festgelegt sind.

XRQuadLayer.transform Eigenschaft

Liefert oder setzt ein <code>XRRigidTransform</code>, das Position und Ausrichtung der Quad-Ebene relativ zu ihrem Referenzraum (<code>space</code>) beschreibt.

XRQuadLayer.width Eigenschaft

Gibt die Breite eines <code>XRQuadLayer</code> in Metern an oder setzt sie. Damit wird die Größe der Ebene im 3D-Raum festgelegt.

XRQuadLayer: redraw Ereignis

Wird an ein <code>XRQuadLayer</code> gesendet, wenn seine Ressourcen verloren gegangen sind oder der XR-Kompositor ihn nicht mehr neu projizieren kann. Der Inhalt muss dann neu gezeichnet werden.

XRRay Schnittstelle

Beschreibt einen geometrischen Strahl der WebXR Device API mit Ursprungspunkt (<code>origin</code>) und normiertem Richtungsvektor (<code>direction</code>), etwa für Hit-Tests.

XRRay.direction Eigenschaft

Liefert als schreibgeschützten <code>DOMPointReadOnly</code> den normalisierten 3D-Richtungsvektor (Länge 1,0) eines <code>XRRay</code>-Strahls.

XRRay.matrix Eigenschaft

Liefert als schreibgeschütztes <code>Float32Array</code> eine 4×4-Transformationsmatrix, mit der sich Objekte entlang eines <code>XRRay</code> ausrichten und positionieren lassen.

XRRay.origin Eigenschaft

Schreibgeschützter <code>DOMPointReadOnly</code>, der den Startpunkt eines <code>XRRay</code> im 3D-Raum in Metern angibt (<code>w</code> ist immer 1).

XRReferenceSpace Schnittstelle

Beschreibt ein Koordinatensystem der WebXR Device API, in dem Posen von Betrachter, Controllern und Objekten relativ zu einem festen Ursprung angegeben werden.

XRReferenceSpace.getOffsetReferenceSpace() Methode

Erzeugt einen neuen <code>XRReferenceSpace</code>, dessen Ursprung gegenüber dem ursprünglichen Referenzraum um eine Position und Ausrichtung (<code>XRRigidTransform</code>) versetzt ist.

XRReferenceSpace: reset Ereignis

Wird an ein <code>XRReferenceSpace</code> gesendet, wenn sein nativer oder effektiver Ursprung plötzlich springt, z. B. nach einer Neukalibrierung oder wenn das Tracking verloren geht und neu startet.

XRReferenceSpaceEvent Schnittstelle

Ereignisobjekt der WebXR Device API, das an einen <code>XRReferenceSpace</code> gesendet wird – vor allem beim <code>reset</code>-Event, wenn sich dessen Ursprung sprunghaft ändert.

XRReferenceSpaceEvent.referenceSpace Eigenschaft

Schreibgeschützte Eigenschaft, die das <code>XRReferenceSpace</code>-Objekt liefert, von dem das Ereignis (typischerweise <code>reset</code>) ausgelöst wurde.

XRReferenceSpaceEvent.transform Eigenschaft

Liefert als <code>XRRigidTransform</code> die neue Position und Orientierung des nativen Ursprungs des Referenzraums, angegeben im Koordinatensystem vor dem Ereignis.

XRRenderState Schnittstelle

Enthält die aktuell gültigen Render-Einstellungen einer <code>XRSession</code>, z. B. Clipping-Ebenen, Sichtfeld und Ziel-Layer, die bestimmen, wie Frames zusammengesetzt werden.

XRRenderState.baseLayer Eigenschaft

Schreibgeschützte Eigenschaft, die die <code>XRWebGLLayer</code> liefert, in die der Browser die Bilder einer XR-Sitzung rendert und die er dann auf dem Gerät anzeigt.

XRRenderState.depthFar Eigenschaft

Schreibgeschützte Zahl, die den Abstand der fernen Clipping-Ebene (Far Plane) vom Betrachter in Metern angibt. Sie fließt in die Projektionsmatrizen der XR-Session ein.

XRRenderState.depthNear Eigenschaft

Schreibgeschützte Eigenschaft, die den Abstand der nahen Abschneideebene (near clipping plane) vom Betrachter in Metern als <code>number</code> liefert.

XRRenderState.inlineVerticalFieldOfView Eigenschaft

Gibt das vertikale Sichtfeld (in Radiant) für <code>"inline"</code>-XR-Sitzungen zurück; bei immersiven Sitzungen ist der Wert <code>null</code>.

XRRenderState.layers Eigenschaft

Schreibgeschütztes, geordnetes Array der <code>XRLayer</code>-Objekte, die der XR-Kompositor für die aktuelle Sitzung übereinanderlegt und anzeigt.

XRRigidTransform Schnittstelle

Beschreibt eine starre 3D-Transformation aus Position (<code>DOMPointReadOnly</code>) und Orientierung (Einheits-Quaternion) und liefert dazu die passende 4×4-Matrix und die inverse Transformation.

XRRigidTransform.inverse Eigenschaft

Liefert ein neues <code>XRRigidTransform</code>, das die Umkehrung der aktuellen Transformation darstellt – also Position und Ausrichtung rückgängig macht.

XRRigidTransform.matrix Eigenschaft

Liefert die durch ein <code>XRRigidTransform</code> beschriebene Transformation als 4×4-Matrix in Spaltenreihenfolge (<code>Float32Array</code> mit 16 Werten).

XRRigidTransform.orientation Eigenschaft

Schreibgeschützter <code>DOMPointReadOnly</code> mit einem Einheitsquaternion (x, y, z, w), der die Rotation einer <code>XRRigidTransform</code> beschreibt.

XRRigidTransform.position Eigenschaft

Schreibgeschützter <code>DOMPointReadOnly</code>, der den Translationsanteil einer <code>XRRigidTransform</code> als 3D-Punkt in Metern angibt.

XRSession Schnittstelle

Steht für eine laufende WebXR-Sitzung zwischen einer Webanwendung und einem XR-Gerät (VR-Headset, AR-fähiges Smartphone) und steuert Render-Schleife, Referenzräume und Eingaben.

XRSession.cancelAnimationFrame() Methode

Bricht einen Callback ab, der zuvor mit <code>XRSession.requestAnimationFrame()</code> für den nächsten XR-Frame angemeldet wurde.

XRSession.depthDataFormat Eigenschaft

Schreibgeschützte Eigenschaft einer <code>immersive-ar</code>-Sitzung, die angibt, in welchem Datenformat der Browser die Tiefensensor-Daten liefert.

XRSession.depthUsage Eigenschaft

Schreibgeschützte Eigenschaft einer <code>immersive-ar</code>-Sitzung. Sie gibt an, ob die Tiefendaten für die CPU (<code>"cpu-optimized"</code>) oder für die GPU (<code>"gpu-optimized"</code>) bereitgestellt werden.

XRSession.domOverlayState Eigenschaft

Schreibgeschützte Eigenschaft einer <code>immersive-ar</code>-<code>XRSession</code>, die Informationen über das aktive DOM-Overlay liefert, oder <code>null</code>, wenn keins aktiv ist.

XRSession.enabledFeatures Eigenschaft

Schreibgeschützte Eigenschaft, die ein Array mit den Funktionen enthält, die der Benutzeragent für eine <code>XRSession</code> tatsächlich aktiviert hat.

XRSession.end() Methode

Beendet die aktuelle <code>XRSession</code> und gibt ein Promise zurück, das erfüllt wird, sobald die Sitzung vollständig heruntergefahren ist.

XRSession.environmentBlendMode Eigenschaft

Schreibgeschützte Eigenschaft, die angibt, ob und wie die gerenderten XR-Bilder mit der realen Umgebung gemischt werden: <code>"opaque"</code>, <code>"additive"</code> oder <code>"alpha-blend"</code>.

XRSession.inputSources Eigenschaft

Schreibgeschützte Eigenschaft, die ein <code>XRInputSourceArray</code> mit allen aktuell mit der XR-Sitzung verbundenen Eingabequellen (Controller, Hände, Blick, Bildschirm-Tap) liefert.

XRSession.interactionMode Eigenschaft

Schreibgeschützte Eigenschaft, die angibt, ob die Bedienoberfläche einer AR-Sitzung am besten im Bildschirmraum (<code>"screen-space"</code>) oder im Weltraum (<code>"world-space"</code>) liegt.

XRSession.preferredReflectionFormat Eigenschaft

Schreibgeschützte Eigenschaft, die das bevorzugte Texturformat (<code>"srgba8"</code> oder <code>"rgba16f"</code>) für Reflexions-Cubemaps der WebXR-Beleuchtungsschätzung liefert.

XRSession.renderState Eigenschaft

Liefert das aktuell gültige <code>XRRenderState</code>-Objekt einer XR-Sitzung mit Einstellungen wie Tiefenbereich, Sichtfeld und Ziel-Layer.

XRSession.requestAnimationFrame() Methode

Plant einen Rückruf, der aufgerufen wird, sobald der Browser bereit ist, den nächsten Frame der XR-Sitzung zu zeichnen. Die Methode gibt eine Kennung zum Abbrechen zurück.

XRSession.requestHitTestSource() Methode

Fordert eine <code>XRHitTestSource</code> an, mit der pro Frame Strahl-Treffer auf realen Oberflächen über <code>XRFrame.getHitTestResults()</code> ermittelt werden.

XRSession.requestHitTestSourceForTransientInput() Methode

Fordert eine Hit-Test-Quelle für kurzlebige Eingaben wie Bildschirmberührungen an. Das Promise wird mit einer <code>XRTransientInputHitTestSource</code> erfüllt.

XRSession.requestLightProbe() Methode

Fordert eine Lichtsonde an und gibt ein Promise zurück, das mit einem <code>XRLightProbe</code> für die Beleuchtungsschätzung der realen Umgebung erfüllt wird.

XRSession.requestReferenceSpace() Methode

Fordert einen Referenzraum eines bestimmten Typs an und liefert ein Promise mit einem <code>XRReferenceSpace</code> oder <code>XRBoundedReferenceSpace</code>.

XRSession.updateRenderState() Methode

Plant Änderungen am Render-Zustand (<code>XRRenderState</code>) einer XR-Sitzung, die beim nächsten Frame wirksam werden – z. B. Ziel-Layer, Clipping-Ebenen oder Sichtfeld.

XRSession.visibilityState Eigenschaft

Schreibgeschützter String, der angibt, ob der Inhalt einer <code>XRSession</code> gerade sichtbar ist und ob er den Eingabefokus hat: <code>"visible"</code>, <code>"visible-blurred"</code> oder <code>"hidden"</code>.

XRSession: end Ereignis

Wird an einer <code>XRSession</code> ausgelöst, sobald die WebXR-Sitzung beendet ist – ob durch <code>end()</code> der Anwendung oder durch den User Agent.

XRSession: inputsourceschange Ereignis

Wird an eine <code>XRSession</code> gesendet, wenn WebXR-Eingabequellen (Controller, Hände, Blick) hinzukommen oder wegfallen.

XRSession: select Ereignis

Wird an eine <code>XRSession</code> gesendet, wenn eine Eingabequelle ihre primäre Aktion abgeschlossen hat, z. B. einen Trigger-Druck, ein Tippen oder eine Pinch-Geste.

XRSession: selectend Ereignis

Wird an eine <code>XRSession</code> gesendet, wenn eine Eingabequelle ihre primäre Aktion beendet oder während einer laufenden primären Aktion getrennt wird.

XRSession: selectstart Ereignis

Wird an eine <code>XRSession</code> gesendet, sobald der Benutzer eine Primäraktion (z. B. Trigger drücken, Pinch-Geste, Tippen auf den Bildschirm) auf einer Eingabequelle beginnt.

XRSession: squeeze Ereignis

Wird an eine <code>XRSession</code> gesendet, sobald eine Eingabequelle ihre primäre Squeeze-Aktion abgeschlossen hat, also z. B. der Greiftaster losgelassen wurde.

XRSession: squeezeend Ereignis

Wird an eine <code>XRSession</code> gesendet, wenn eine Eingabequelle ihre primäre Greifaktion (Squeeze) beendet, abbricht oder während der Aktion getrennt wird.

XRSession: squeezestart Ereignis

Wird an eine <code>XRSession</code> gesendet, sobald der Benutzer an einer Eingabequelle eine primäre Greif- bzw. Quetschaktion (etwa am Grip-Taster) beginnt.

XRSession: visibilitychange Ereignis

Wird an eine <code>XRSession</code> gesendet, wenn sich ihr <code>visibilityState</code> ändert – also wenn sie sichtbar, versteckt oder sichtbar, aber ohne Fokus wird.

XRSession: visibilitymaskchange Ereignis

Wird an eine <code>XRSession</code> gesendet, wenn sich der für den Benutzer sichtbare Bereich (die Sichtbarkeitsmaske) einer <code>XRView</code> ändert.

XRSessionEvent Schnittstelle

Ereignisobjekt der WebXR Device API, das eine Zustandsänderung einer <code>XRSession</code> meldet, etwa ihr Ende (<code>end</code>) oder eine geänderte Sichtbarkeit (<code>visibilitychange</code>).

XRSessionEvent.session Eigenschaft

Schreibgeschützte Eigenschaft, die die <code>XRSession</code> liefert, auf die sich ein <code>XRSessionEvent</code> (z. B. <code>end</code> oder <code>visibilitychange</code>) bezieht.

XRSpace Schnittstelle

Abstrakte Basisschnittstelle der WebXR Device API für ein Koordinatensystem, das in der XR-Szene verfolgt wird, etwa den Raum des Betrachters, eines Controllers oder eines Ankers.

XRSubImage Schnittstelle

Beschreibt über <code>viewport</code>, in welchen Bildausschnitt (Viewport) einer GPU-Textur für eine WebXR-Ebene (Layer) gerendert werden soll.

XRSubImage.viewport Eigenschaft

Schreibgeschützte Eigenschaft, die den <code>XRViewport</code> liefert, also den Pixelbereich der Textur, in den ein Teilbild einer WebXR-Ebene gerendert wird.

XRSystem Schnittstelle

Einstiegspunkt der WebXR Device API: prüft, welche XR-Sitzungsmodi unterstützt werden, und startet über <code>navigator.xr</code> eine <code>XRSession</code> für VR oder AR.

XRSystem.isSessionSupported() Methode

Prüft asynchron, ob das WebXR-Gerät des Nutzers einen bestimmten Sitzungsmodus (<code>inline</code>, <code>immersive-vr</code>, <code>immersive-ar</code>) unterstützt.

XRSystem.requestSession() Methode

Fordert eine WebXR-Sitzung im angegebenen Modus an und gibt ein Promise zurück, das mit einem <code>XRSession</code>-Objekt erfüllt wird.

XRSystem: devicechange Ereignis

Wird auf <code>navigator.xr</code> (<code>XRSystem</code>) ausgelöst, wenn sich die Verfügbarkeit immersiver XR-Geräte ändert, z. B. beim Anschließen oder Trennen eines VR-Headsets.

XRTransientInputHitTestResult Schnittstelle

Enthält die Hit-Test-Ergebnisse eines Frames für <strong>eine</strong> transiente Eingabequelle (z. B. einen Bildschirm-Tipp), bestehend aus <code>inputSource</code> und <code>results</code>.

XRTransientInputHitTestResult.inputSource Eigenschaft

Schreibgeschützte Eigenschaft, die die <code>XRInputSource</code> liefert, für die das <code>results</code>-Array dieses Hit-Test-Ergebnisses berechnet wurde.

XRTransientInputHitTestResult.results Eigenschaft

Schreibgeschütztes Array von <code>XRHitTestResult</code>-Objekten mit den Treffern einer transienten Eingabequelle (z. B. Bildschirm-Tipp) in der realen Umgebung.

XRTransientInputHitTestSource Schnittstelle

Verwaltet ein Hittest-Abonnement für flüchtige Eingabequellen wie Bildschirm-Taps in AR-Sitzungen und liefert pro Frame die Treffer über <code>XRFrame.getHitTestResultsForTransientInput()</code>.

XRTransientInputHitTestSource.cancel() Methode

Meldet einen transienten Eingabe-Treffertest ab. Danach liefert die Quelle keine Ergebnisse mehr, und der Browser kann die zugehörigen Ressourcen freigeben.

XRView Schnittstelle

Beschreibt eine einzelne Ansicht (z. B. ein Auge) in die XR-Szene für einen bestimmten Frame, inklusive Projektionsmatrix und Blickpunkt-Transformation.

XRView.eye Eigenschaft

Schreibgeschützter String, der angibt, für welches Auge ein <code>XRView</code> gerendert wird: <code>"left"</code>, <code>"right"</code> oder <code>"none"</code>.

XRView.index Eigenschaft

Die schreibgeschützte Eigenschaft <code>index</code> gibt die Position der aktuellen <code>XRView</code> im Array <code>XRViewerPose.views</code> an.

XRView.isFirstPersonObserver Eigenschaft

Schreibgeschützter boolescher Wert, der angibt, ob ein <code>XRView</code> eine First-Person-Observer-Ansicht ist, etwa für Videoaufnahmen aus Sicht einer am Gerät angebrachten Kamera.

XRView.projectionMatrix Eigenschaft

Liefert die 4×4-Projektionsmatrix (<code>Float32Array</code>) einer <code>XRView</code>, mit der Szenenkoordinaten für genau diese Ansicht (z. B. ein Auge) auf den Bildschirm projiziert werden.

XRView.recommendedViewportScale Eigenschaft

Schreibgeschützter, vom User-Agent empfohlener Skalierungsfaktor (0–1] für den Viewport einer <code>XRView</code>, gedacht zur Übergabe an <code>requestViewportScale()</code>.

XRView.requestViewportScale() Methode

Fordert den Browser auf, den Viewport dieser <code>XRView</code> mit einem Skalierungsfaktor zwischen 0 und 1 zu verkleinern. So lässt sich die Renderlast in WebXR dynamisch senken.

XRView.transform Eigenschaft

Schreibgeschütztes <code>XRRigidTransform</code>, das Position und Orientierung des Blickpunkts einer <code>XRView</code> relativ zum Referenzraum aus <code>getViewerPose()</code> beschreibt.

XRViewerPose Schnittstelle

Das Interface <code>XRViewerPose</code> beschreibt Position und Orientierung des Betrachters in einem Referenzraum und enthält pro Auge bzw. Anzeige eine <code>XRView</code>.

XRViewerPose.views Eigenschaft

Schreibgeschütztes, eingefrorenes Array aller <code>XRView</code>-Objekte, die für einen Frame gerendert werden müssen, um die Szene aus Sicht des Betrachters vollständig darzustellen.

XRViewport Schnittstelle

Beschreibt Position und Größe des Rechteckbereichs innerhalb einer <code>XRWebGLLayer</code>, in den eine einzelne <code>XRView</code> (z. B. ein Auge) gerendert wird.

XRViewport.height Eigenschaft

Schreibgeschützte Eigenschaft, die die Höhe des Viewports in Pixeln angibt, in dem eine WebXR-Ansicht auf der Zeichenfläche gerendert werden soll.

XRViewport.width Eigenschaft

Schreibgeschützte Eigenschaft: gibt die Breite des Viewports in Pixeln an, also des Bereichs der Zeichenfläche, in den eine XR-Ansicht gerendert wird.

XRViewport.x Eigenschaft

Schreibgeschützte Ganzzahl: horizontaler Versatz in Pixeln von der linken Kante der Zieloberfläche (z. B. <code>XRWebGLLayer</code>) bis zur linken Kante des Viewports.

XRViewport.y Eigenschaft

Schreibgeschützte Ganzzahl: der Abstand in Pixeln von der unteren Kante der Zieloberfläche (meist ein <code>XRWebGLLayer</code>) bis zur unteren Kante des Viewports.

XRVisibilityMaskChangeEvent Schnittstelle

Ereignis der WebXR Device API, das beim Ändern der Sichtbarkeitsmaske einer <code>XRView</code> ausgelöst wird und die für den Benutzer sichtbare Fläche als Dreiecksnetz liefert.

XRVisibilityMaskChangeEvent.eye Eigenschaft

Schreibgeschützte Eigenschaft, die angibt, für welches Auge (<code>"left"</code>, <code>"right"</code> oder <code>"none"</code>) die gelieferte Sichtbarkeitsmaske gilt.

XRVisibilityMaskChangeEvent.index Eigenschaft

Schreibgeschützte Ganzzahl, die angibt, zu welcher <code>XRView</code> im Array <code>XRViewerPose.views</code> die geänderte Sichtbarkeitsmaske gehört.

XRVisibilityMaskChangeEvent.indices Eigenschaft

Schreibgeschütztes <code>Uint32Array</code> mit Vertex-Indizes, die je zu dritt ein Dreieck der sichtbaren Fläche einer <code>XRView</code> bilden.

XRVisibilityMaskChangeEvent.session Eigenschaft

Schreibgeschützte Eigenschaft, die die <code>XRSession</code> zurückgibt, auf der das <code>visibilitymaskchange</code>-Ereignis ausgelöst wurde.

XRVisibilityMaskChangeEvent.vertices Eigenschaft

Schreibgeschütztes <code>Float32Array</code> mit den Koordinaten der Eckpunkte, aus denen die Sichtbarkeitsmaske einer <code>XRView</code> besteht.

XRWebGLBinding Schnittstelle

Verbindet eine <code>XRSession</code> mit einem WebGL-Kontext und erzeugt GPU-gestützte XR-Ebenen (Projektions-, Quad-, Zylinder-, Würfel- und Equirect-Ebenen) samt ihren Texturen.

XRWebGLBinding.createCubeLayer() Methode

Erzeugt ein <code>XRCubeLayer</code>, das eine Cubemap direkt auf die Innenflächen eines den Betrachter umgebenden Würfels rendert – ideal für Skyboxen und 360°-Umgebungen.

XRWebGLBinding.createCylinderLayer() Methode

Erzeugt ein <code>XRCylinderLayer</code>, also eine WebGL-gerenderte Ebene auf der Innenseite eines Zylinderausschnitts im XR-Raum, z. B. für gekrümmte Menüs oder Videoflächen.

XRWebGLBinding.createEquirectLayer() Methode

Erzeugt ein <code>XREquirectLayer</code>, das equirektangular kodierte Bilddaten (z. B. 360°-Panoramen) auf die Innenseite einer Kugel abbildet.

XRWebGLBinding.createProjectionLayer() Methode

Erzeugt einen <code>XRProjectionLayer</code>, der die gesamte Sicht des Betrachters ausfüllt und mit nahezu nativer Bildrate des XR-Geräts aktualisiert wird.

XRWebGLBinding.createQuadLayer() Methode

Erzeugt ein <code>XRQuadLayer</code>, also eine flache, rechteckige Kompositionsebene, die frei im 3D-Raum einer WebXR-Sitzung platziert wird.

XRWebGLBinding.getDepthInformation() Methode

Gibt für eine <code>XRView</code> ein <code>XRWebGLDepthInformation</code>-Objekt zurück, dessen WebGL-Textur die Tiefendaten der realen Umgebung enthält.

XRWebGLBinding.getReflectionCubeMap() Methode

Gibt eine <code>WebGLTexture</code> mit der aktuellen Reflexions-Cube-Map einer <code>XRLightProbe</code> zurück, um realistische Spiegelungen in AR zu rendern.

XRWebGLBinding.getSubImage() Methode

Liefert für eine WebXR-Kompositionsebene und den aktuellen Frame ein <code>XRWebGLSubImage</code> mit der WebGL-Textur und dem Viewport, in den gerendert werden soll.

XRWebGLBinding.getViewSubImage() Methode

Gibt ein <code>XRWebGLSubImage</code> zurück, das die WebGL-Farb- und Tiefentextur samt Viewport enthält, in die eine bestimmte <code>XRView</code> einer Projektionsebene gerendert wird.

XRWebGLBinding.nativeProjectionScaleFactor Eigenschaft

Schreibgeschützte Zahl, mit der die Standardauflösung einer Projektionsschicht multipliziert werden muss, um die native Auflösung des XR-Geräts zu erreichen.

XRWebGLDepthInformation Schnittstelle

Liefert die Tiefenkarte einer WebXR-AR-Sitzung als WebGL-Textur für eine Ansicht; zurückgegeben von <code>XRWebGLBinding.getDepthInformation()</code>.

XRWebGLDepthInformation.texture Eigenschaft

Schreibgeschützte Eigenschaft mit einem <code>WebGLTexture</code>, das die Tiefeninformationen des aktuellen XR-Frames als undurchsichtige Textur für Shader bereitstellt.

XRWebGLLayer Schnittstelle

Verbindet eine WebXR-Sitzung mit einem WebGL-Kontext und stellt den Framebuffer bereit, in den die XR-Szene für jedes Auge bzw. jede Ansicht gerendert wird.

XRWebGLLayer.antialias Eigenschaft

Die schreibgeschützte Eigenschaft <code>antialias</code> gibt an, ob der Framebuffer einer <code>XRWebGLLayer</code> tatsächlich Anti-Aliasing (Kantenglättung) unterstützt.

XRWebGLLayer.fixedFoveation Eigenschaft

Liest oder setzt die Stärke der festen Foveation (0 bis 1), mit der der XR-Compositor die Randbereiche einer <code>XRWebGLLayer</code> in geringerer Auflösung rendert.

XRWebGLLayer.framebuffer Eigenschaft

Schreibgeschütztes, undurchsichtiges <code>WebGLFramebuffer</code>, in das eine WebXR-App ihr Bild rendert, damit der XR-Kompositor es an das Gerät weitergibt.

XRWebGLLayer.framebufferHeight Eigenschaft

Schreibgeschützte Eigenschaft, die die Höhe des WebGL-Framebuffers einer <code>XRWebGLLayer</code> in Pixeln liefert.

XRWebGLLayer.framebufferWidth Eigenschaft

Schreibgeschützte Eigenschaft von <code>XRWebGLLayer</code>, die die Breite des WebXR-Framebuffers in Pixeln als Ganzzahl liefert.

XRWebGLLayer.getNativeFramebufferScaleFactor() Methode

Statische Methode, die den Skalierungsfaktor liefert, mit dem der Standard-Framebuffer einer <code>XRSession</code> auf die native Auflösung des XR-Geräts gebracht wird.

XRWebGLLayer.getViewport() Methode

Gibt den <code>XRViewport</code> zurück, also den Bereich im Framebuffer der WebGL-Schicht, in den ein bestimmter <code>XRView</code> (z. B. ein Auge) gerendert werden soll.

XRWebGLLayer.ignoreDepthValues Eigenschaft

Schreibgeschützter Boolescher Wert: <code>true</code>, wenn der XR-Compositor den Tiefenpuffer der Ebene beim Zusammensetzen des Bildes nicht verwendet.

XRWebGLSubImage Schnittstelle

Beschreibt die WebGL-Texturen (Farbe, Tiefe/Stencil, Bewegungsvektoren) und den Viewport, in die für eine WebXR-Schicht (<code>XRCompositionLayer</code>) in einem Frame gerendert wird.

XRWebGLSubImage.colorTexture Eigenschaft

Liefert das schreibgeschützte Farb-<code>WebGLTexture</code>, in das für den aktuellen Frame der Inhalt einer <code>XRCompositionLayer</code> gerendert wird.

XRWebGLSubImage.colorTextureHeight Eigenschaft

Schreibgeschützte Zahl mit der Höhe der Farbtextur (<code>colorTexture</code>) eines <code>XRWebGLSubImage</code> in Pixeln.

XRWebGLSubImage.colorTextureWidth Eigenschaft

Schreibgeschützte Zahl mit der Breite der Farbtextur (<code>colorTexture</code>) eines <code>XRWebGLSubImage</code> in Pixeln.

XRWebGLSubImage.depthStencilTexture Eigenschaft

Schreibgeschützte Eigenschaft mit der Tiefen-/Stencil-<code>WebGLTexture</code>, in die für eine <code>XRCompositionLayer</code> gerendert wird – oder <code>null</code>, falls keine existiert.

XRWebGLSubImage.imageIndex Eigenschaft

Schreibgeschützter Index der Ebene im Texturarray, in die für das aktuelle Auge gerendert wird, wenn der Layer mit <code>textureType: "texture-array"</code> angelegt wurde. Sonst <code>null</code>.

XSLTProcessor Schnittstelle

Wendet ein XSLT-1.0-Stylesheet auf ein XML-Dokument oder einen Knoten an und liefert das Ergebnis als neues <code>Document</code> oder <code>DocumentFragment</code>.

XSLTProcessor.clearParameters() Methode

Entfernt alle mit <code>setParameter()</code> gesetzten Parameterwerte aus dem <code>XSLTProcessor</code>, sodass wieder die Standardwerte der <code>&lt;xsl:param&gt;</code>-Deklarationen gelten.

XSLTProcessor.getParameter() Methode

Gibt den Wert eines XSLT-Parameters (<code>&lt;xsl:param&gt;</code>) zurück, der zuvor mit <code>setParameter()</code> im <code>XSLTProcessor</code> gesetzt wurde.

XSLTProcessor.importStylesheet() Methode

Importiert ein XSLT-Stylesheet (als DOM-Knoten) in einen <code>XSLTProcessor</code>, damit dieser anschließend XML-Dokumente transformieren kann.

XSLTProcessor.removeParameter() Methode

Entfernt einen zuvor mit <code>setParameter()</code> gesetzten XSLT-Parameter. Danach gilt wieder der Standardwert aus dem <code>&lt;xsl:param&gt;</code> des Stylesheets.

XSLTProcessor.reset() Methode

Entfernt alle gesetzten Parameter (<code>&lt;xsl:param&gt;</code>) und das importierte XSLT-Stylesheet, sodass der <code>XSLTProcessor</code> wieder im Ausgangszustand ist.

XSLTProcessor.setParameter() Methode

Setzt den Wert eines globalen <code>&lt;xsl:param&gt;</code> im importierten XSLT-Stylesheet, bevor die Transformation ausgeführt wird.

XSLTProcessor.transformToDocument() Methode

Wendet das importierte XSLT-Stylesheet auf einen Knoten an und gibt das Ergebnis als neues, eigenständiges <code>Document</code> zurück.

XSLTProcessor.transformToFragment() Methode

Wendet das importierte XSLT-Stylesheet auf einen Quellknoten an und gibt das Ergebnis als <code>DocumentFragment</code> zurück, das einem Zieldokument gehört.