Accessibility.snapshot() 方法

擷取目前可存取性樹狀結構的狀態。返回的物件代表頁面的根可存取節點。

簽名

class Accessibility {
  snapshot(options?: SnapshotOptions): Promise<SerializedAXNode | null>;
}

參數

參數	類型	描述
options	SnapshotOptions	(可選)

返回

Promise<SerializedAXNode | null>

一個代表快照的 AXNode 物件。

備註

注意 Chrome 可存取性樹狀結構包含在大多數平台和大多數螢幕閱讀器上未使用的節點。除非將 interestingOnly 設為 false，否則 Puppeteer 也會將它們捨棄，以便更容易處理樹狀結構。

範例 1

一個傾印整個可存取性樹狀結構的範例

const snapshot = await page.accessibility.snapshot();
console.log(snapshot);

範例 2

一個記錄焦點節點名稱的範例

const snapshot = await page.accessibility.snapshot();
const node = findFocusedNode(snapshot);
console.log(node && node.name);

function findFocusedNode(node) {
  if (node.focused) return node;
  for (const child of node.children || []) {
    const foundNode = findFocusedNode(child);
    return foundNode;
  }
  return null;
}