Document element selection - grafana/k6#3519 (#1479)

Co-authored-by: Heitor Tashiro Sergent <[email protected]>

Author: mstoykov

…s/next/javascript-api/k6-html/element.md …javascript-api/k6-html/element/_index.mddocs/sources/next/javascript-api/k6-html/element.md renamed to docs/sources/next/javascript-api/k6-html/element/_index.md docs/sources/next/javascript-api/k6-html/element.md renamed to docs/sources/next/javascript-api/k6-html/element/_index.md

@@ -16,6 +16,7 @@ The Element object provides a similar API to the [DOM Element API](https://devel
 
 | Method                 | Description                                                                                                                                                              |
 | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [selection](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-html/element/element-selection) | The selection matching the element.                                                                                                                       |
 | nodeName               | The name of the element.                                                                                                                                                 |
 | nodeType               | The type of the element.                                                                                                                                                 |
 | nodeValue              | The element value.                                                                                                                                                       |

docs/sources/next/javascript-api/k6-html/element/element-selection.md

@@ -0,0 +1,34 @@
+---
+title: 'Element.selection()'
+description: 'Retrieve the Selection matching this element.'
+---
+
+# Element.selection()
+
+Retrieve the Selection matching this element.
+
+Mimics `$(element)`.
+
+### Returns
+
+| Type    | Description                          |
+| ------- | ------------------------------------ |
+| Selection | The Selection matching this element. |
+
+### Example
+
+{{< code >}}
+
+```javascript
+import http from "k6/http";
+
+export default () => {
+	let li = http.get("https://test.k6.io").html().find("li");
+	li.each(function(_, element) {
+		let container = element.selection().closest('ul.header-icons');
+		console.log("li.each", container.html())
+	});
+}
+
+```
+{{< /code >}}