XRFrame: getJointPose() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The getJointPose() method of the XRFrame interface returns an XRJointPose object providing the pose of a hand joint (see XRHand) relative to a given base space.

Syntax

getJointPose(joint, baseSpace)

Parameters

joint: An XRJointSpace specifying the hand joint space for which to obtain an XRJointPose describing the item's position and orientation.
baseSpace: An XRSpace to use as the base or origin for the relative position and orientation.

Return value

An XRJointPose object specifying the position and orientation of the hand joint, relative to the XRSpace indicated by baseSpace.

Examples

Using `getJointPose()`

Call getJointPose() with an XRJointSpace and an XRReferenceSpace to get an XRJointPose object.

navigator.xr
  .requestSession({ optionalFeatures: ["hand-tracking"] })
  .then(/* … */);

function renderFrame(session, frame) {
  // …

  for (const inputSource of session.inputSources) {
    if (inputSource.hand) {
      const indexFingerTipJoint = inputSource.hand.get("index-finger-tip");
      frame.getJointPose(indexFingerTipJoint, referenceSpace); // XRJointPose
    }
  }
}

Specifications

Specification
WebXR Hand Input Module - Level 1 # dom-xrframe-getjointpose

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`getJointPose` Experimental	Chrome – Full support Chrome 131 (Release date: 2024-11-12) footnote Full support	Edge – No support Edge 93 – 110 (Release date: 2021-09-02) footnote Removed in 111 and later footnote Hololens 2 only.	Firefox – No support Firefox footnote No support	Opera – Full support Opera 116 (Release date: 2025-01-08) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 131 (Release date: 2024-11-12) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 87 (Release date: 2025-01-22) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 29 (Release date: 2025-10-25) footnote Full support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: Experimental. Expect behavior to change in the future.

XRFrame: getJointPose() method

Legend