Add import.meta.resolve documentation

docs/sources/.eslintrc.js

@@ -1,12 +1,13 @@
 module.exports = {
   root: true,
   env: {
-    es2017: true,
+    es2022: true,
     commonjs: true,
   },
   parserOptions: {
-    ecmaVersion: '2017',
+    ecmaVersion: '2024',
     sourceType: 'module',
+    requireConfigFile: false, // <== ADD THIS
   },
   extends: ['plugin:mdx/recommended', 'plugin:prettier/recommended'],
   plugins: ['markdown'],

docs/sources/next/javascript-api/_index.md

@@ -11,6 +11,14 @@ The list of k6 modules natively supported in your k6 scripts.
 
 {{< docs/shared source="k6" lookup="javascript-api/init-context.md" version="<K6_VERSION>" >}}
 
+## Import.meta
+
+`import.meta` is only available in ECMAScript modules, but not CommonJS ones.
+
+| Function                                                                                           | Description                                               |
+| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [import.meta.resolve](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/import.meta/resolve) | resolve path to URL the same way that an ESM import would |
+
 ## k6
 
 {{< docs/shared source="k6" lookup="javascript-api/k6.md" version="<K6_VERSION>" >}}

docs/sources/next/javascript-api/import.meta/_index.md

@@ -0,0 +1,11 @@
+---
+title: 'import.meta'
+description: 'the ECMAScript import meta property'
+weight: 20
+---
+
+# import.meta
+
+| Function                                                                                           | Description                                               |
+| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [import.meta.resolve](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/import.meta/resolve) | resolve path to URL the same way that an ESM import would |

docs/sources/next/javascript-api/import.meta/resolve.md

@@ -0,0 +1,32 @@
+---
+title: 'resolve( path )'
+description: 'Resolve a path to a URL strign the same way an import would.'
+---
+
+# resolve(path)
+
+Resolve a path to a URL string the same way an import would.
+
+This is useful if you want to provide a path relative to the current module to a function that will use `open` or some other function taking URLs.
+
+This is particularly useful as some functions within k6 are not relative to the same origin, which might lead to seemingly similar paths having very different file being loaded from the filesystem.
+
+For ongoing discussions please see this [issue](https://github.com/grafana/k6/issues/3857).
+
+| Parameter | Type   | Description                |
+| --------- | ------ | -------------------------- |
+| path      | string | a path to a potential file |
+
+### Example
+
+{{< code >}}
+
+```javascript
+const pdfFile = open(import.meta.resolve('./path/to/file.pdf'), 'b');
+
+export default function () {
+  // this is here to not have an exception if ran in k6
+}
+```
+
+{{< /code >}}