/** * The default cooperative request interception resolution priority * * @public */ export const DEFAULT_INTERCEPT_RESOLUTION_PRIORITY = 0; /** * Represents an HTTP request sent by a page. * @remarks * * Whenever the page sends a request, such as for a network resource, the * following events are emitted by Puppeteer's `page`: * * - `request`: emitted when the request is issued by the page. * - `requestfinished` - emitted when the response body is downloaded and the * request is complete. * * If request fails at some point, then instead of `requestfinished` event the * `requestfailed` event is emitted. * * All of these events provide an instance of `HTTPRequest` representing the * request that occurred: * * ``` * page.on('request', request => ...) * ``` * * NOTE: HTTP Error responses, such as 404 or 503, are still successful * responses from HTTP standpoint, so request will complete with * `requestfinished` event. * * If request gets a 'redirect' response, the request is successfully finished * with the `requestfinished` event, and a new request is issued to a * redirected url. * * @public */ export class HTTPRequest { /** * @internal */ _requestId = ''; /** * @internal */ _interceptionId; /** * @internal */ _failureText = null; /** * @internal */ _response = null; /** * @internal */ _fromMemoryCache = false; /** * @internal */ _redirectChain = []; /** * Warning! Using this client can break Puppeteer. Use with caution. * * @experimental */ get client() { throw new Error('Not implemented'); } /** * @internal */ constructor() { } /** * The URL of the request */ url() { throw new Error('Not implemented'); } /** * The `ContinueRequestOverrides` that will be used * if the interception is allowed to continue (ie, `abort()` and * `respond()` aren't called). */ continueRequestOverrides() { throw new Error('Not implemented'); } /** * The `ResponseForRequest` that gets used if the * interception is allowed to respond (ie, `abort()` is not called). */ responseForRequest() { throw new Error('Not implemented'); } /** * The most recent reason for aborting the request */ abortErrorReason() { throw new Error('Not implemented'); } /** * An InterceptResolutionState object describing the current resolution * action and priority. * * InterceptResolutionState contains: * action: InterceptResolutionAction * priority?: number * * InterceptResolutionAction is one of: `abort`, `respond`, `continue`, * `disabled`, `none`, or `already-handled`. */ interceptResolutionState() { throw new Error('Not implemented'); } /** * Is `true` if the intercept resolution has already been handled, * `false` otherwise. */ isInterceptResolutionHandled() { throw new Error('Not implemented'); } enqueueInterceptAction() { throw new Error('Not implemented'); } /** * Awaits pending interception handlers and then decides how to fulfill * the request interception. */ async finalizeInterceptions() { throw new Error('Not implemented'); } /** * Contains the request's resource type as it was perceived by the rendering * engine. */ resourceType() { throw new Error('Not implemented'); } /** * The method used (`GET`, `POST`, etc.) */ method() { throw new Error('Not implemented'); } /** * The request's post body, if any. */ postData() { throw new Error('Not implemented'); } /** * An object with HTTP headers associated with the request. All * header names are lower-case. */ headers() { throw new Error('Not implemented'); } /** * A matching `HTTPResponse` object, or null if the response has not * been received yet. */ response() { throw new Error('Not implemented'); } /** * The frame that initiated the request, or null if navigating to * error pages. */ frame() { throw new Error('Not implemented'); } /** * True if the request is the driver of the current frame's navigation. */ isNavigationRequest() { throw new Error('Not implemented'); } /** * The initiator of the request. */ initiator() { throw new Error('Not implemented'); } /** * A `redirectChain` is a chain of requests initiated to fetch a resource. * @remarks * * `redirectChain` is shared between all the requests of the same chain. * * For example, if the website `http://example.com` has a single redirect to * `https://example.com`, then the chain will contain one request: * * ```ts * const response = await page.goto('http://example.com'); * const chain = response.request().redirectChain(); * console.log(chain.length); // 1 * console.log(chain[0].url()); // 'http://example.com' * ``` * * If the website `https://google.com` has no redirects, then the chain will be empty: * * ```ts * const response = await page.goto('https://google.com'); * const chain = response.request().redirectChain(); * console.log(chain.length); // 0 * ``` * * @returns the chain of requests - if a server responds with at least a * single redirect, this chain will contain all requests that were redirected. */ redirectChain() { throw new Error('Not implemented'); } /** * Access information about the request's failure. * * @remarks * * @example * * Example of logging all failed requests: * * ```ts * page.on('requestfailed', request => { * console.log(request.url() + ' ' + request.failure().errorText); * }); * ``` * * @returns `null` unless the request failed. If the request fails this can * return an object with `errorText` containing a human-readable error * message, e.g. `net::ERR_FAILED`. It is not guaranteed that there will be * failure text if the request fails. */ failure() { throw new Error('Not implemented'); } async continue() { throw new Error('Not implemented'); } async respond() { throw new Error('Not implemented'); } async abort() { throw new Error('Not implemented'); } } /** * @public */ export var InterceptResolutionAction; (function (InterceptResolutionAction) { InterceptResolutionAction["Abort"] = "abort"; InterceptResolutionAction["Respond"] = "respond"; InterceptResolutionAction["Continue"] = "continue"; InterceptResolutionAction["Disabled"] = "disabled"; InterceptResolutionAction["None"] = "none"; InterceptResolutionAction["AlreadyHandled"] = "already-handled"; })(InterceptResolutionAction || (InterceptResolutionAction = {})); /** * @internal */ export function headersArray(headers) { const result = []; for (const name in headers) { const value = headers[name]; if (!Object.is(value, undefined)) { const values = Array.isArray(value) ? value : [value]; result.push(...values.map(value => { return { name, value: value + '' }; })); } } return result; } /** * @internal * * @remarks * List taken from {@link https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml} * with extra 306 and 418 codes. */ export const STATUS_TEXTS = { '100': 'Continue', '101': 'Switching Protocols', '102': 'Processing', '103': 'Early Hints', '200': 'OK', '201': 'Created', '202': 'Accepted', '203': 'Non-Authoritative Information', '204': 'No Content', '205': 'Reset Content', '206': 'Partial Content', '207': 'Multi-Status', '208': 'Already Reported', '226': 'IM Used', '300': 'Multiple Choices', '301': 'Moved Permanently', '302': 'Found', '303': 'See Other', '304': 'Not Modified', '305': 'Use Proxy', '306': 'Switch Proxy', '307': 'Temporary Redirect', '308': 'Permanent Redirect', '400': 'Bad Request', '401': 'Unauthorized', '402': 'Payment Required', '403': 'Forbidden', '404': 'Not Found', '405': 'Method Not Allowed', '406': 'Not Acceptable', '407': 'Proxy Authentication Required', '408': 'Request Timeout', '409': 'Conflict', '410': 'Gone', '411': 'Length Required', '412': 'Precondition Failed', '413': 'Payload Too Large', '414': 'URI Too Long', '415': 'Unsupported Media Type', '416': 'Range Not Satisfiable', '417': 'Expectation Failed', '418': "I'm a teapot", '421': 'Misdirected Request', '422': 'Unprocessable Entity', '423': 'Locked', '424': 'Failed Dependency', '425': 'Too Early', '426': 'Upgrade Required', '428': 'Precondition Required', '429': 'Too Many Requests', '431': 'Request Header Fields Too Large', '451': 'Unavailable For Legal Reasons', '500': 'Internal Server Error', '501': 'Not Implemented', '502': 'Bad Gateway', '503': 'Service Unavailable', '504': 'Gateway Timeout', '505': 'HTTP Version Not Supported', '506': 'Variant Also Negotiates', '507': 'Insufficient Storage', '508': 'Loop Detected', '510': 'Not Extended', '511': 'Network Authentication Required', }; //# sourceMappingURL=HTTPRequest.js.map