Selection on Grafana Labs

Selection.attr(name)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.attr(name)

Get the value of an attribute for the first element in the Selection. Mimics jquery.attr

Parameter	Type	Description
name	string	The name of the attribute to get

Returns

Type	Description
string	The value of the attribute

Example

import { parseHTML } from 'k6/html';
import http from 'k6/http';

export default function () {
  const res = http.get('https://k6.io');
  const doc = parseHTML(res.body);
  const langAttr = doc.find('html').attr('lang');
}

Selection.children([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.children([selector])

Get the children of each element in the set of matched elements, optionally filtered by a selector. Mimics jquery.children

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	The children Selection.

Example

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);
  const sel = doc.find('dl');

  console.log(sel.children().size());
  console.log(sel.children('dt').size());

  sleep(1);
}

Selection.closest(selector)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.closest(selector)

For each element in the set, get the first element that matches the selector by testing the element itself and traversing up through its ancestors in the DOM tree. Mimics jquery.closest

Parameter	Type	Description
selector	string	A string containing a selector expression to match elements against

Returns

Type	Description
Selection	Selection.

Example

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

export default function () {
  const content = `
  <ul id="one" class="level-1">
  <li class="item-i">I</li>
  <li id="ii" class="item-ii">II
    <ul class="level-2">
      <li class="item-a">A</li>
      <li class="item-b">B
        <ul class="level-3">
          <li class="item-1">1</li>
          <li class="item-2">2</li>
          <li class="item-3">3</li>
        </ul>
      </li>
      <li class="item-c">C</li>
    </ul>
  </li>
  <li class="item-iii">III</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li.item-a').closest('ul');
  console.log(sel.attr('class'));
  sleep(1);
}

Selection.contents()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.contents()

Get the children of each element in the set of matched elements, including text and comment nodes. Mimics jquery.contents.

Returns

Type	Description
Selection	Selection.

Example

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);

  const sel = doc.find('dt');

  console.log(sel.contents().text());

  sleep(1);
}

Selection.data([key])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.data([key])

Return the value at the named data store for the first element in the set of matched elements. Mimics jquery.data

Parameter	Type	Description
key (optional)	string	A string naming the piece of data to set.

Returns

Type	Description
string	The value at the named data store.

Example

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

export default function () {
  const content = `
 <h1 data-test-id="data-value">Hola</h1>
  `;

  const doc = parseHTML(content);
  const sel = doc.find('h1');

  console.log(sel.data().testID);
  console.log(sel.data('test-id'));
  console.log(sel.data('testId'));

  sleep(1);
}

Selection.each(fn)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.each(fn)

Iterate over a Selection, executing a function for each matched element. Mimics jquery.each

Parameter	Type	Description
fn	function	A function to iterate all the Elements of the Collection.

Example

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);

  doc.find('dl').each(function (idx, el) {
    console.log(el.innerHTML());
  });

  sleep(1);
}

Selection.eq(index)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.eq(index)

Reduce the set of matched elements to the one at the specified index. Mimics jquery.eq.

Parameter	Type	Description
index	Number	An integer indicating the 0-based position of the element.

Returns

Type	Description
Selection	A Selection.

Example

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);

  const sel = doc.find('dt');

  console.log(sel.eq(0).html());
  console.log(sel.eq(1).html());
  console.log(sel.eq(2).html());

  sleep(1);
}

Selection.filter(selector)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.filter(selector)

Reduce the set of matched elements to those that match the selector or pass the function’s test. Mimics jquery.filter

Parameter	Type	Description
selector	function	A function used as a test for each element in the set.
selector	string	A string containing a selector expression to match elements against.
selector	Selection	A selection to match elements against.

Returns

Type	Description
Selection	The filter selection.

Example

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 sel;
  const els = doc.find('dl').children();

  sel = els.filter('#term-2');
  console.log(sel.text());

  sel = els.filter(function (idx, el) {
    return el.text() === 'definition 3-a';
  });
  console.log(sel.text());

  sel = els.filter(doc.find('dl dt#term-1'));
  console.log(sel.text());

  sleep(1);
}

Selection.find(selector)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.find(selector)

Find the selection descendants, filtered by a selector. It returns a Selection object. Mimics jquery.find

Parameter	Type	Description
selector	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	Selection object.

Example

import { parseHTML } from 'k6/html';
import http from 'k6/http';

export default function () {
  const res = http.get('https://k6.io');
  const doc = parseHTML(res.body);

  const titleDoc = doc.find('head title');
  const title = titleDoc.text();
}

Selection.first()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.first()

Reduce the set of matched elements to the first in the set. Mimics jquery.first.

Returns

Type	Description
Selection	The first element of the Selection.

Example

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);

  const sel = doc.find('dt');

  console.log(sel.first().html());

  sleep(1);
}

Selection.get(index)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.get(index)

Retrieve the Element matched by the selector. Mimics jquery.get

Parameter	Type	Description
index	Number	A zero-based integer indicating which element to retrieve.

Returns

Type	Description
Element	The Element matched by the selector.

Example

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);

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

  console.log(sel.get(0).innerHTML());
  console.log(sel.get(1).innerHTML());

  sleep(1);
}

Selection.has(selector)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.has(selector)

Reduce the set of matched elements to those that have a descendant that matches the selector. Mimics jquery.has.

Parameter	Type	Description
selector	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
 <ul>
  <li>list item 1</li>
  <li>list item 2
    <ul>
      <li>list item 2-a</li>
      <li>list item 2-b</li>
    </ul>
  </li>
  <li>list item 3</li>
  <li>list item 4</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li').has('ul');

  console.log(sel.html());

  sleep(1);
}

Selection.html()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.html()

Get the HTML contents of the first element in the set of matched elements. Mimics jquery.html

Returns

Type	Description
string	The HTML content of the first element in the set of matched elements.

Example

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);

  const sel = doc.find('dt');

  console.log(sel.html());

  sleep(1);
}

Selection.is(selector)

Mon, 21 Sep 2026 15:16:28 +0000

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

Parameter	Type	Description
selector	function	A function used as a test for each element in the set
selector	string	A string containing a selector expression to match elements against.
selector	Selection	A selection.

Returns

Type	Description
Selection	The filter selection.

Example

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);
}

Selection.last()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.last()

Reduce the set of matched elements to the final one in the set. Mimics jquery.last.

Returns

Type	Description
Selection	The final element of the Selection.

Example

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);

  const sel = doc.find('dt');

  console.log(sel.last().html());

  sleep(1);
}

Selection.map(fn)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.map(fn)

Pass each selection in the current matched set through a function, producing a new Array containing the return values. Mimics jquery.each

Parameter	Type	Description
fn	function	A function to iterate all the Selections of the Collection.

Returns

Type	Description
Array	The array containing the return values.

Example

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);

  const newEls = doc
    .find('dl')
    .children()
    .map(function (idx, el) {
      return 'hola ' + el.text();
    });

  console.log(newEls);

  sleep(1);
}

Selection.next([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.next([selector])

Get the immediately following sibling of each element in the set of matched elements Mimics jquery.next.

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li.third-item').next();

  console.log(sel.html());

  sleep(1);
}

Selection.nextAll([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.nextAll([selector])

Get all following siblings of each element in the set of matched elements, optionally filtered by a selector. Mimics jquery.nextAll.

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li.third-item').nextAll();

  console.log(sel.size());

  sleep(1);
}

Selection.nextUntil([selector], [filter])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.nextUntil([selector], [filter])

Get all following siblings of each element up to but not including the element matched by the selector. Mimics jquery.nextUntil

Parameter	Type	Description
selector (optional)	string \| Selection \| `null`	A selector expression or object to match elements against.
filter (optional)	string \| `null`	A selector expression to filter matched elements.

Returns

Type	Description
Selection	A Selection.

Example

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);

  const sel = doc.find('#term-2').nextUntil('dt');
  console.log(sel.size());

  const selFilter = doc.find('#term-1').nextUntil('#term-3', 'dd');
  console.log(selFilter.size());

  sleep(1);
}

Selection.not(selector)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.not(selector)

Remove elements from the set of matched elements. Mimics jquery.not

Parameter	Type	Description
selector	string	A string containing a selector expression to match elements against.
selector	function	A function used as a test for each element in the set.

Returns

Type	Description
Selection	A Selection.

Example

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 sel = doc.find('dl').children();

  console.log(sel.not('dt').size());

  sel = sel.not(function (idx, item) {
    return item.text().startsWith('definition');
  });

  console.log(sel.size());

  sleep(1);
}

Selection.parent([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.parent([selector])

Get the parent of each element in the current set of matched elements, optionally filtered by a selector. Mimics jquery.parent.

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li.third-item').parent();

  console.log(sel.html());

  sleep(1);
}

Selection.parents([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.parents([selector])

Get the ancestors of each element in the current set of matched elements, optionally filtered by a selector. Mimics jquery.parents.

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li.third-item').parents();

  console.log(sel.size());

  sleep(1);
}

Selection.parentsUntil([selector], [filter])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.parentsUntil([selector], [filter])

Get the ancestors of each element in the current set of matched elements, up to but not including the element matched by the selector. Mimics jquery.parentsUntil

Parameter	Type	Description
selector (optional)	string \| Selection \| `null`	A selector expression or object to match elements against.
filter (optional)	string \| `null`	A selector expression to filter matched elements.

Returns

Type	Description
Selection	A Selection.

Example

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);

  const sel = doc.find('#term-2').parentsUntil('dt');
  console.log(sel.size());

  const selFilter = doc.find('#term-3').parentsUntil('dt', 'dd');
  console.log(selFilter.size());

  sleep(1);
}

Selection.prev([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.prev([selector])

Get the immediately preceding sibling of each element in the set of matched elements. Mimics jquery.prev.

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>
  `;
  const doc = parseHTML(content);
  const sel = doc.find('li.third-item').prev();

  console.log(sel.html());

  sleep(1);
}

Selection.prevAll([selector])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.prevAll([selector])

Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector. Mimics jquery.prevAll.

Parameter	Type	Description
selector (optional)	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	A Selection.

Example

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

export default function () {
  const content = `
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>
  `;
  const doc = parseHTML(content);

  const sel = doc.find('li.third-item').prevAll();

  console.log(sel.size());

  sleep(1);
}

Selection.prevUntil([selector], [filter])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.prevUntil([selector], [filter])

Get all preceding siblings of each element up to but not including the element matched by the selector. Mimics jquery.prevUntil.

Parameter	Type	Description
selector (optional)	string \| Selection \| `null`	A selector expression or object to match elements against.
filter (optional)	string \| `null`	A selector expression to filter matched elements.

Returns

Type	Description
Selection	A Selection.

Example

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);

  const sel = doc.find('#term-2').prevUntil('dt');
  console.log(sel.size());

  const selFilter = doc.find('#term-3').prevUntil('#term-1', 'dd');
  console.log(selFilter.size());

  sleep(1);
}

Selection.serialize()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.serialize()

Encode a set of form elements as a string in standard URL-encoded notation for submission. Mimics jquery.serialize

Returns

Type	Description
string	The URL-encoded representation of the matched form or form elements.

Example

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

export default function () {
  const content = `
 <form><input name="username"></form>
  `;

  const doc = parseHTML(content);
  const sel = doc.find('form');
  const serialized = sel.serialize();

  console.log(serialized); // "username="

  sleep(1);
}

Selection.serializeArray()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.serializeArray()

Encode a set of form elements as an array of names and values ([{ name: "name", value: "value" }, ...]). Mimics jquery.serializeArray

Returns

Type	Description
array	Array of names and values of the matched form or form elements.

Example

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

export default function () {
  const content = `
 <form><input name="username"></form>
  `;

  const doc = parseHTML(content);
  const sel = doc.find('form');
  const serialized = sel.serializeArray();

  console.log(JSON.stringify(serialized)); // [{"name": "username", "value": ""}]

  sleep(1);
}

Selection.serializeObject()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.serializeObject()

Encode a set of form elements as an object ({ "inputName": "value", "checkboxName": "value" }).

Returns

Type	Description
object	Object representation of the matched form or form elements, key is field name and value is field value.

Example

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

export default function () {
  const content = `
 <form><input name="username"></form>
  `;

  const doc = parseHTML(content);
  const sel = doc.find('form');
  const serialized = sel.serializeObject();

  console.log(JSON.stringify(serialized)); // {"username": ""}

  sleep(1);
}

Selection.single(selector)

Mon, 21 Sep 2026 15:16:28 +0000

Selection.single(selector)

Returns at most one element matching the selector, as a Selection object. It’s backed by goquery’s Single matcher, which is faster than find() when you only need the first match.

Parameter	Type	Description
selector	string	A string containing a selector expression to match elements against.

Returns

Type	Description
Selection	Selection object.

Example

import { parseHTML } from 'k6/html';
import http from 'k6/http';

export default function () {
  const res = http.get('https://k6.io');
  const doc = parseHTML(res.body);

  const title = doc.single('h1').text();
}

Selection.size()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.size()

Return the number of elements in the Selection. Mimics jquery.size

Returns

Type	Description
Number	The number of elements in the Selection.

Example

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);

  const sel = doc.find('dt');

  console.log(sel.size());

  sleep(1);
}

Selection.slice(start [, end])

Mon, 21 Sep 2026 15:16:28 +0000

Selection.slice(start [, end])

Reduce the set of matched elements to a subset specified by a range of indices. Mimics jquery.slice

Parameter	Type	Description
start	Number	An integer indicating the 0-based position at which the elements begin to be selected.
end	Number	An integer indicating the 0-based position at which the elements stop being selected.
selector	Selection	A selection.

Returns

Type	Description
Selection	The new selection.

Example

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);

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

  console.log(els.slice(4).text());

  console.log(els.slice(2, 4).text());

  sleep(1);
}

Selection.text()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.text()

Get the text content of the Selection. Mimics jquery.text.

Returns

Type	Description
string	Selection text content.

Example

import { parseHTML } from 'k6/html';
import http from 'k6/http';

export default function () {
  const res = http.get('https://k6.io');
  const doc = parseHTML(res.body);
  const pageTitle = doc.find('head title').text();
}

Selection.toArray()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.toArray()

Retrieve all the elements contained in the Selection, as an array. Mimics jquery.toArray.

Returns

Type	Description
Array of Selection	Array of Selection objects.

Example

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);

  doc
    .find('dl')
    .children()
    .toArray()
    .forEach(function (item) {
      console.log(item.text());
    });

  sleep(1);
}

Selection.val()

Mon, 21 Sep 2026 15:16:28 +0000

Selection.val()

Get the current value of the first element in the set of matched elements. Mimics jquery.val.

Returns

Type	Description
string	The value of the first element in the set of matched elements.

Example

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

export default function () {
  const content = `
                <input id="text_input" type="text" value="input-text-value"/>
                <select id="select_one">
                        <option value="not this option">no</option>
                        <option value="yes this option" selected>yes</option>
                </select>
                <select id="select_text">
                        <option>no text</option>
                        <option selected>yes text</option>
                </select>
                <select id="select_multi" multiple>
                        <option>option 1</option>
                        <option selected>option 2</option>
                        <option selected>option 3</option>
                </select>
                <textarea id="textarea" multiple>Lorem ipsum dolor sit amet</textarea>
  `;
  const doc = parseHTML(content);

  console.log(doc.find('#text_input').val());
  console.log(doc.find('#select_one option[selected]').val());
  console.log(doc.find('#select_one').val());
  console.log(doc.find('#select_text').val());
  console.log(doc.find('#select_multi').val());
  console.log(doc.find('#textarea').val());

  sleep(1);
}