@types/k6 1.4.0 → 1.6.0

k6/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for k6 (https://grafana.com/docs/k6/lates
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/k6.
 
 ### Additional Details
- * Last updated: Mon, 10 Nov 2025 13:11:26 GMT
+ * Last updated: Tue, 10 Feb 2026 09:47:03 GMT
  * Dependencies: none
 
 # Credits

k6/browser/index.d.ts

@@ -3231,6 +3231,29 @@ export interface Locator {
      */
     press(key: string, options?: KeyboardPressOptions): Promise<void>;
 
+    /**
+     * Focuses the element and then sends a `keydown`, `keypress`/`input`, and
+     * `keyup` event for each character in the text.
+     *
+     * This method is useful for simulating real user typing behavior when the page
+     * has special keyboard event handling, such as input validation or autocomplete.
+     * For simple text input without special keyboard handling, use {@link fill | fill()}
+     * instead as it's faster and more reliable.
+     *
+     * @example
+     * ```js
+     * // Type text instantly
+     * await locator.pressSequentially('Hello World');
+     *
+     * // Type text with delay between keypresses (like a real user)
+     * await locator.pressSequentially('Hello World', { delay: 100 });
+     * ```
+     *
+     * @param text Text to type into the focused element character by character.
+     * @param options Typing options.
+     */
+    pressSequentially(text: string, options?: KeyboardPressOptions): Promise<void>;
+
     /**
      * Type a text into the input field.
      * @param text Text to type into the input field.
@@ -4868,6 +4891,39 @@ export interface Page {
      */
     on(event: "response", listener: (response: Response) => void): void;
 
+    /**
+     * Registers a handler function to listen for network requests that
+     * fail to reach the server (DNS errors, connection refused, timeouts, etc.).
+     * The handler will receive an instance of {@link Request}, which includes
+     * information about the failed request.
+     *
+     * **Usage**
+     *
+     * ```js
+     * page.on('requestfailed', request => {
+     *   const failure = request.failure();
+     *   console.log(`Request failed: ${request.url()}`);
+     *   console.log(`  Error: ${failure ? failure.errorText : 'unknown'}`);
+     * });
+     * ```
+     */
+    on(event: "requestfailed", listener: (request: Request) => void): void;
+
+    /**
+     * Registers a handler function to listen for network requests that
+     * successfully complete (receive a response). The handler will receive an
+     * instance of {@link Request}, which includes information about the request.
+     *
+     * **Usage**
+     *
+     * ```js
+     * page.on('requestfinished', request => {
+     *   console.log(`Request finished: ${request.method()} ${request.url()}`);
+     * });
+     * ```
+     */
+    on(event: "requestfinished", listener: (request: Request) => void): void;
+
     /**
      * Returns the page that opened the current page. The first page that is
      * navigated to will have a null opener.
@@ -4967,6 +5023,37 @@ export interface Page {
         waitUntil?: "load" | "domcontentloaded" | "networkidle";
     }): Promise<Response | null>;
 
+    /**
+     * Goes back to the previous page in the history.
+     *
+     * @example
+     * ```js
+     * await page.goto('https://example.com');
+     * await page.goto('https://example.com/page2');
+     * await page.goBack(); // Will navigate back to the first page
+     * ```
+     *
+     * @param options Navigation options.
+     * @returns A promise that resolves to the response of the requested navigation when it happens.
+     * Returns null if there is no previous entry in the history.
+     */
+    goBack(options?: NavigationOptions): Promise<Response | null>;
+
+    /**
+     * Goes forward to the next page in the history.
+     *
+     * @example
+     * ```js
+     * await page.goBack(); // Navigate back first
+     * await page.goForward(); // Then navigate forward
+     * ```
+     *
+     * @param options Navigation options.
+     * @returns A promise that resolves to the response of the requested navigation when it happens.
+     * Returns null if there is no next entry in the history.
+     */
+    goForward(options?: NavigationOptions): Promise<Response | null>;
+
     /**
      * Adds a route to the page to modify network requests made by that page.
      *
@@ -5693,6 +5780,120 @@ export interface Page {
         },
     ): Promise<Request | null>;
 
+    /**
+     * Waits for the specified event to be emitted.
+     *
+     * This method blocks until the event is captured or the timeout is reached.
+     * Supported event types are `console`, `request`, or `response`.
+     *
+     * @example
+     * ```js
+     * // Wait for a console message containing 'hello'
+     * const msgPromise = page.waitForEvent('console', msg => msg.text().includes('hello'));
+     * await page.evaluate(() => console.log('hello world'));
+     * const msg = await msgPromise;
+     * ```
+     *
+     * @param event Event name to wait for: `'console'`.
+     * @param optionsOrPredicate Either a predicate function or an options object.
+     */
+    waitForEvent(
+        event: "console",
+        optionsOrPredicate?:
+            | ((msg: ConsoleMessage) => boolean)
+            | {
+                /**
+                 * Predicate function that returns `true` when the expected event is received.
+                 */
+                predicate?: (msg: ConsoleMessage) => boolean;
+                /**
+                 * Maximum time to wait in milliseconds. Defaults to `30` seconds.
+                 * The default value can be changed via the
+                 * browserContext.setDefaultTimeout(timeout) or
+                 * page.setDefaultTimeout(timeout) methods.
+                 *
+                 * Setting the value to `0` will disable the timeout.
+                 */
+                timeout?: number;
+            },
+    ): Promise<ConsoleMessage>;
+
+    /**
+     * Waits for the specified event to be emitted.
+     *
+     * This method blocks until the event is captured or the timeout is reached.
+     * It can wait for any page event such as `console`, `request`, or `response`.
+     *
+     * @example
+     * ```js
+     * // Wait for a request to a specific URL
+     * const reqPromise = page.waitForEvent('request', req => req.url().includes('/api'));
+     * await page.click('button');
+     * const req = await reqPromise;
+     * ```
+     *
+     * @param event Event name to wait for: `'request'`.
+     * @param optionsOrPredicate Either a predicate function or an options object.
+     */
+    waitForEvent(
+        event: "request",
+        optionsOrPredicate?:
+            | ((req: Request) => boolean)
+            | {
+                /**
+                 * Predicate function that returns `true` when the expected event is received.
+                 */
+                predicate?: (req: Request) => boolean;
+                /**
+                 * Maximum time to wait in milliseconds. Defaults to `30` seconds.
+                 * The default value can be changed via the
+                 * browserContext.setDefaultTimeout(timeout) or
+                 * page.setDefaultTimeout(timeout) methods.
+                 *
+                 * Setting the value to `0` will disable the timeout.
+                 */
+                timeout?: number;
+            },
+    ): Promise<Request>;
+
+    /**
+     * Waits for the specified event to be emitted.
+     *
+     * This method blocks until the event is captured or the timeout is reached.
+     * It can wait for any page event such as `console`, `request`, or `response`.
+     *
+     * @example
+     * ```js
+     * // Wait for a response from a specific URL
+     * const resPromise = page.waitForEvent('response', res => res.url().includes('/api'));
+     * await page.click('button');
+     * const res = await resPromise;
+     * ```
+     *
+     * @param event Event name to wait for: `'response'`.
+     * @param optionsOrPredicate Either a predicate function or an options object.
+     */
+    waitForEvent(
+        event: "response",
+        optionsOrPredicate?:
+            | ((res: Response) => boolean)
+            | {
+                /**
+                 * Predicate function that returns `true` when the expected event is received.
+                 */
+                predicate?: (res: Response) => boolean;
+                /**
+                 * Maximum time to wait in milliseconds. Defaults to `30` seconds.
+                 * The default value can be changed via the
+                 * browserContext.setDefaultTimeout(timeout) or
+                 * page.setDefaultTimeout(timeout) methods.
+                 *
+                 * Setting the value to `0` will disable the timeout.
+                 */
+                timeout?: number;
+            },
+    ): Promise<Response>;
+
     /**
      * **NOTE** Use web assertions that assert visibility or a locator-based
      * locator.waitFor([options]) instead.
@@ -5866,6 +6067,25 @@ export interface Request {
      * @returns request URL
      */
     url(): string;
+
+    /**
+     * Returns the failure info for a failed request, or null if the request succeeded.
+     * This method returns information about network failures such as DNS errors,
+     * connection refused, timeouts, etc. It does not return information for HTTP
+     * 4xx/5xx responses, which are successful network requests.
+     * @returns The failure information or null if the request succeeded.
+     */
+    failure(): RequestFailure | null;
+}
+
+/**
+ * RequestFailure contains information about a failed request.
+ */
+export interface RequestFailure {
+    /**
+     * The error text describing why the request failed.
+     */
+    errorText: string;
 }
 
 /**

k6/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/k6",
-    "version": "1.4.0",
+    "version": "1.6.0",
     "description": "TypeScript definitions for k6",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/k6",
     "license": "MIT",
@@ -63,7 +63,7 @@
         "./experimental/fs": "./experimental/fs/index.d.ts",
         "./experimental/redis": "./experimental/redis/index.d.ts",
         "./experimental/streams": "./experimental/streams/index.d.ts",
-        "./experimental/websockets": "./experimental/websockets/index.d.ts",
+        "./websockets": "./websockets/index.d.ts",
         "./package.json": "./package.json"
     },
     "repository": {
@@ -74,6 +74,6 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {},
-    "typesPublisherContentHash": "3389c07b59b7207b250360cc9a2fe81354853b03a9211c4cf5f0afb159dfa567",
+    "typesPublisherContentHash": "80b31eb39ecab6afca265e96b2a78fd11aa9904f1e43aca2188ce7631b0d7e2c",
     "typeScriptVersion": "5.2"
 }

k6/{experimental/websockets → websockets}/index.d.ts

@@ -1,11 +1,10 @@
-import { CookieJar } from "../../http/index.js";
-import { ReadableStream } from "../streams/index.js";
+import { ReadableStream } from "../experimental/streams/index.js";
+import { CookieJar } from "../http/index.js";
 
 /**
- * This module provides an experimental implementation of the WebSocket API
- * for k6.
+ * This module provides a WebSocket API for k6.
  *
- * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/
+ * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/
  */
 
 /**
@@ -43,7 +42,7 @@ export class WebSocket {
 
     /**
      * The Websocket constructor returns a newly created WebSocket object.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/
      *
      * @param url - The URL to which to connect; this should be the URL to which the WebSocket server will respond.
      * @param protocols - Either a single protocol string or an array of protocol strings. The param is reserved for future use and will be presently ignored.
@@ -53,7 +52,7 @@ export class WebSocket {
 
     /**
      * Enqueues data to be transmitted to the server over the WebSocket connection.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-send/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-send/
      *
      * @param data - the data to send to the server
      */
@@ -62,7 +61,7 @@ export class WebSocket {
     /**
      * Bind event names to event handlers to be executed when their
      * respective event is received by the server.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-addeventlistener/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-addeventlistener/
      *
      * @param event - the event to listen for
      * @param listener - the callback to invoke when the event is emitted
@@ -71,7 +70,7 @@ export class WebSocket {
 
     /**
      * Closes the WebSocket connection or connection attempt, if any.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-close/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-close/
      *
      * @param code - An integer WebSocket connection close code value indicating a reason for closure.
      * @param reason - A human-readable string WebSocket connection close reason. No longer than 123 bytes of UTF-8 text.
@@ -80,13 +79,13 @@ export class WebSocket {
 
     /**
      * Sends a ping message over the WebSocket connection.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-ping/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-ping/
      */
     ping(): void;
 
     /**
      * Sets an event handler which is invoked when a message event happens.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-onmessage/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-onmessage/
      *
      * @param event - the message event
      */
@@ -94,19 +93,19 @@ export class WebSocket {
 
     /**
      * Sets an event handler which is invoked when the WebSocket connection's opens.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-onopen/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-onopen/
      */
     onopen: () => void;
 
     /**
      * Sets an event handler which is invoked when the WebSocket connection's closes.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-onclose/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-onclose/
      */
     onclose: () => void;
 
     /**
      * Sets an event handler which is invoked when errors occur.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-onerror/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-onerror/
      *
      * @param event - the error event
      */
@@ -114,13 +113,13 @@ export class WebSocket {
 
     /**
      * Sets an event handler which is invoked when a ping message is received.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-onping/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-onping/
      */
     onping: () => void;
 
     /**
      * Sets an event handler which is invoked when a pong message is received.
-     * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/websocket/websocket-onpong/
+     * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/websocket/websocket-onpong/
      */
     onpong: () => void;
 }
@@ -147,7 +146,7 @@ export class Blob {
 
 /**
  * k6 specific WebSocket parameters.
- * https://grafana.com/docs/k6/latest/javascript-api/k6-experimental/websockets/params/
+ * https://grafana.com/docs/k6/latest/javascript-api/k6-websockets/params/
  */
 export interface Params {
     /** Request headers. */