Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Selection.is(selector)

Check the current matched set of elements against a selector or element and return true if at least one of these elements matches the given arguments. Mimics jquery.is

ParameterTypeDescription
selectorfunctionA function used as a test for each element in the set
selectorstringA string containing a selector expression to match elements against.
selectorSelectionA selection.

Returns

TypeDescription
SelectionThe filter selection.

Example

JavaScript
import { parseHTML } from 'k6/html';
import { sleep } from 'k6';

export default function () {
  const content = `
<dl>
  <dt id="term-1">term 1</dt>
  <dd>definition 1-a</dd>
  <dd>definition 1-b</dd>
  <dd>definition 1-c</dd>
  <dd>definition 1-d</dd>

  <dt id="term-2">term 2</dt>
  <dd>definition 2-a</dd>
  <dd>definition 2-b</dd>
  <dd>definition 2-c</dd>

  <dt id="term-3">term 3</dt>
  <dd>definition 3-a</dd>
  <dd>definition 3-b</dd>
</dl>
  `;
  const doc = parseHTML(content);

  let result;

  const els = doc.find('dl').children();

  result = els.is('dd');
  console.log(result);

  result = els.is(function (idx, el) {
    return el.text() === 'hola';
  });
  console.log(result);

  result = els.is(els.first());
  console.log(result);

  sleep(1);
}