Function query

lib/command/query.js:8–98

(locator, context, options = {})

import { xpathLocator } from '../utils.js'

export default async function query(locator, context, options = {}) {
  const html = options.file ? fs.readFileSync(options.file, 'utf8') : await readStdin()

  if (!html || !html.trim()) {
    console.error('codeceptq: no HTML input. Pipe HTML via stdin or use --file <path>.')
    process.exitCode = 2
    return
  }

  let xpathExpr
  let contextExpr = null
  try {
    xpathExpr = buildXPath(locator, options)
    if (context) contextExpr = buildXPath(context, {})
  } catch (err) {
    console.error(`codeceptq: cannot build XPath: ${err.message}`)
    process.exitCode = 2
    return
  }

  const { doc, source } = htmlToDoc(html)

  let nodes
  try {
    if (contextExpr) {
      const ctxNodes = toArray(xpath.select(contextExpr, doc))
      const seen = new Set()
      nodes = []
      for (const ctx of ctxNodes) {
        for (const m of toArray(xpath.select(xpathExpr, ctx))) {
          if (!seen.has(m)) {
            seen.add(m)
            nodes.push(m)
          }
        }
      }
    } else {
      nodes = toArray(xpath.select(xpathExpr, doc))
    }
  } catch (err) {
    console.error(`codeceptq: XPath evaluation failed for "${xpathExpr}": ${err.message}`)
    process.exitCode = 2
    return
  }

  const limit = parseInt(options.limit, 10) || 20
  const snippetLen = parseInt(options.snippet, 10) || 500
  const truncated = nodes.slice(0, limit)
  const where = options.file || 'stdin'

  if (options.json) {
    process.stdout.write(
      JSON.stringify(
        {
          locator,
          context: context || null,
          xpath: xpathExpr,
          contextXPath: contextExpr,