Query Utilities

import { xml2js, findChild } from "@office-open/xml";

const root = xml2js("<w:p><w:r><w:t>Hello</w:t></w:r></w:p>");
const run = findChild(root, "w:r");

import { xml2js, children } from "@office-open/xml";

const root = xml2js("<w:p><w:r/><w:r/><w:r/></w:p>");
const runs = children(root, "w:r"); // 3 elements

import { allChildren } from "@office-open/xml";

const all = allChildren(root);

import { xml2js, findChild, childText } from "@office-open/xml";

const root = xml2js("<w:p><w:r><w:t>Hello</w:t></w:r></w:p>");
const text = childText(root, "w:t"); // "Hello"

import { textOf } from "@office-open/xml";

const textEl = findChild(run, "w:t");
const text = textOf(textEl); // "Hello"

import { collectText } from "@office-open/xml";

const allText = collectText(paragraph); // Concatenated text content

import { xml2js, findChild, attr } from "@office-open/xml";

const element = xml2js('<w:spacing w:before="240" w:after="120"/>');
attr(element, "w:before"); // "240"
attr(element, "w:after"); // "120"

attrNum(element, "w:before"); // 240

attrBool(element, "w:val"); // true or false based on "true"/"1"/"false"/"0"

import { attrMeasure } from "@office-open/xml";

attrMeasure(spacing, "w:before"); // 240 (number) for a plain token
attrMeasure(width, "w:w", "pct"); // "5000" kept verbatim (fiftieths of a percent)

import { colorAttr } from "@office-open/xml";

colorAttr(element, "w:color"); // "FF0000"

import { hasChild } from "@office-open/xml";

hasChild(paragraph, "w:pPr"); // true or false

import { findDeep } from "@office-open/xml";

const allTextNodes = findDeep(document, "w:t");

import { findFirst } from "@office-open/xml";

const firstT = findFirst(document, "w:t");

import { childCount } from "@office-open/xml";

childCount(paragraph); // 3