Method fetch

playwright/async_api/_generated.py:21111–21216

APIRequestContext.fetch Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update context cookies from the response. The method will automatically follow redirects. **Usage** JSON objects can be passed dire

(
        self,
        url_or_request: typing.Union[str, "Request"],
        *,
        params: typing.Optional[
            typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
        ] = None,
        method: typing.Optional[str] = None,
        headers: typing.Optional[typing.Dict[str, str]] = None,
        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
        form: typing.Optional[
            typing.Union[typing.Dict[str, typing.Union[str, float, bool]], "FormData"]
        ] = None,
        multipart: typing.Optional[
            typing.Union[
                typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]],
                "FormData",
            ]
        ] = None,
        timeout: typing.Optional[typing.Union[float, datetime.timedelta]] = None,
        fail_on_status_code: typing.Optional[bool] = None,
        ignore_https_errors: typing.Optional[bool] = None,
        max_redirects: typing.Optional[int] = None,
        max_retries: typing.Optional[int] = None,
    )

        )

    async def fetch(
        self,
        url_or_request: typing.Union[str, "Request"],
        *,
        params: typing.Optional[
            typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
        ] = None,
        method: typing.Optional[str] = None,
        headers: typing.Optional[typing.Dict[str, str]] = None,
        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
        form: typing.Optional[
            typing.Union[typing.Dict[str, typing.Union[str, float, bool]], "FormData"]
        ] = None,
        multipart: typing.Optional[
            typing.Union[
                typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]],
                "FormData",
            ]
        ] = None,
        timeout: typing.Optional[typing.Union[float, datetime.timedelta]] = None,
        fail_on_status_code: typing.Optional[bool] = None,
        ignore_https_errors: typing.Optional[bool] = None,
        max_redirects: typing.Optional[int] = None,
        max_retries: typing.Optional[int] = None,
    ) -> "APIResponse":
        """APIRequestContext.fetch

        Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and
        update context cookies from the response. The method will automatically follow redirects.

        **Usage**

        JSON objects can be passed directly to the request:

        ```python
        data = {
            \"title\": \"Book Title\",
            \"body\": \"John Doe\",
        }
        api_request_context.fetch(\"https://example.com/api/createBook\", method=\"post\", data=data)
        ```

        The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
        encoding, by specifiying the `multipart` parameter:

        Parameters
        ----------
        url_or_request : Union[Request, str]
            Target URL or Request to get all parameters from.
        params : Union[Dict[str, Union[bool, float, str]], str, None]
            Query parameters to be sent with the URL.
        method : Union[str, None]
            If set changes the fetch method (e.g. [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) or
            [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST)). If not specified, GET method is used.
        headers : Union[Dict[str, str], None]
            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
            it.
        data : Union[Any, bytes, str, None]