Puppeteer 中文文档v25.8.0

HTTPResponse 类

HTTPResponse 类表示由 Page 类接收的响应。

签名

export declare abstract class HTTPResponse

备注

此类的构造函数被标记为内部。第三方代码不应直接调用构造函数,也不应创建继承 HTTPResponse 类的子类。

方法

方法

修饰符

说明

buffer()

一个 Promise,其解析为包含响应体的缓冲区。

备注:

缓冲区可能由浏览器根据 HTTP 头部或其他启发式规则重新编码。如果浏览器未能检测到正确的编码,缓冲区可能编码错误。参见 https://github.com/puppeteer/puppeteer/issues/6478。

content()

一个 Promise,其解析为包含响应体的缓冲区。

备注:

缓冲区可能由浏览器根据 HTTP 头部或其他启发式规则重新编码。如果浏览器未能检测到正确的编码,缓冲区可能编码错误。参见 https://github.com/puppeteer/puppeteer/issues/6478。

frame()

发起此响应的 Frame,如果导航到错误页面则为 null

fromCache()

如果响应来自浏览器的磁盘缓存或内存缓存,则为 true。

fromServiceWorker()

如果响应由 service worker 提供,则为 true。

headers()

一个包含与响应关联的 HTTP 头部的对象。所有头部名称均为小写。重复的头部值会合并为单个以逗号分隔的列表,但 Set-Cookie 除外,它以 \n 分隔。

json()

一个 Promise,其解析为响应体的 JSON 表示。

备注:

如果响应体无法通过 JSON.parse 解析,此方法将抛出错误。

ok()

如果响应成功(状态码在 200-299 范围内),则为 true。

remoteAddress()

用于连接远程服务器的 IP 地址和端口号。

request()

一个匹配的 HTTPRequest 对象。

securityDetails()

如果响应是通过安全连接接收的,则为 SecurityDetails,否则为 null

status()

响应的状态码(例如,成功时为 200)。

statusText()

响应的状态文本(例如,成功时通常为 "OK")。

text()

一个 Promise,其解析为响应体的文本(utf8)表示。

备注:

如果内容不是 utf-8 字符串,此方法将抛出错误。

timing()

与响应相关的计时信息。

url()

响应的 URL。