unist-util-select/lib/parse.js

unist utility to select nodes with CSS-like selectors

/**
 * @typedef {import('css-selector-parser').AstSelector} AstSelector
 */

import {createParser} from 'css-selector-parser'

const cssSelectorParse = createParser({syntax: 'selectors-4'})

/**
 * @param {string} selector
 * @returns {AstSelector}
 */
export function parse(selector) {
  if (typeof selector !== 'string') {
    throw new TypeError('Expected `string` as selector, not `' + selector + '`')
  }

  return cssSelectorParse(selector)
}