APIRequest

公开可用于 Web API 测试的 API。此类用于创建 APIRequestContext 实例，反过来可用于发送 Web 请求。可通过 Playwright.APIRequest 获取此类的实例。更多信息请参阅 APIRequestContext。

方法

NewContextAsync

添加于: v1.16

apiRequest.NewContextAsync

创建 APIRequestContext 的新实例。

用法

await ApiRequest.NewContextAsync(options);

参数

options ApiRequestNewContextOptions? （可选）
- BaseURL string? （可选）#
  
  诸如 ApiRequestContext.GetAsync() 等方法通过使用 URL() 构造函数构建相应 URL 来考虑基本 URL。示例
  - 基本 URL: http://localhost:3000，向 /bar.html 发送请求的结果是 http://localhost:3000/bar.html
  - 基本 URL: http://localhost:3000/foo/，向 ./bar.html 发送请求的结果是 http://localhost:3000/foo/bar.html
  - 基本 URL: http://localhost:3000/foo （没有尾部斜杠），导航到 ./bar.html 的结果是 http://localhost:3000/bar.html
- ClientCertificates IEnumerable?<ClientCertificates> （可选）添加于: 1.46#
  - Origin string
    
    证书有效的确切来源。来源包括 https 协议、主机名以及可选的端口。
  - CertPath string? （可选）
    
    PEM 格式证书文件的路径。
  - Cert byte[]? （可选）
    
    PEM 格式证书的直接值。
  - KeyPath string? （可选）
    
    PEM 格式私钥文件的路径。
  - Key byte[]? （可选）
    
    PEM 格式私钥的直接值。
  - PfxPath string? （可选）
    
    PFX 或 PKCS12 编码的私钥和证书链文件的路径。
  - Pfx byte[]? （可选）
    
    PFX 或 PKCS12 编码的私钥和证书链的直接值。
  - Passphrase string? （可选）
    
    私钥（PEM 或 PFX）的密码短语。
  TLS 客户端认证允许服务器请求并验证客户端证书。
  
  详情
  
  要使用的客户端证书数组。每个证书对象必须同时具有 certPath 和 keyPath，或单独具有 pfxPath，或它们对应的直接值形式（cert 和 key，或 pfx）。可选地，如果证书已加密，应提供 passphrase 属性。应提供 origin 属性，其值与证书有效的请求来源完全匹配。
  
  注意
  在 macOS 上使用 WebKit 时，访问 localhost 将无法加载客户端证书。您可以通过将 localhost 替换为 local.playwright 来使其工作。
- ExtraHTTPHeaders IDictionary?<string, string> （可选）#
  
  一个对象，包含要随每个请求发送的附加 HTTP 头部。默认为无。
- FailOnStatusCode bool? （可选）添加于: v1.51#
  
  是否对 2xx 和 3xx 以外的响应状态码抛出异常。默认情况下，所有状态码都会返回响应对象。
- HttpCredentials HttpCredentials? （可选）#
  - Username string
  - Password string
  - Origin string? （可选）
    
    限制在特定来源 (scheme://host) 发送 HTTP 凭据:port).
  - Send enum HttpCredentialsSend { Unauthorized, Always }? （可选）
    
    此选项仅适用于从相应的 APIRequestContext 发送的请求，不影响从浏览器发送的请求。'always' - 基本认证凭据的 Authorization 头部将随每个 API 请求发送。'unauthorized' - 凭据仅在收到带有 WWW-Authenticate 头部且状态码为 401 (Unauthorized) 的响应时发送。默认为 'unauthorized'。
  HTTP 认证的凭据。如果未指定来源，用户名和密码将在收到未经授权的响应时发送到任何服务器。
- IgnoreHTTPSErrors bool? （可选）#
  
  发送网络请求时是否忽略 HTTPS 错误。默认为 false。
- MaxRedirects int? （可选）添加于: v1.52#
  
  自动跟随的最大请求重定向次数。如果超过该次数，将抛出错误。默认为 20。传入 0 表示不跟随重定向。此设置可以单独为每个请求覆盖。
- Proxy Proxy? （可选）#
  - Server string
    
    用于所有请求的代理。支持 HTTP 和 SOCKS 代理，例如 http://myproxy.com:3128 或 socks5://myproxy.com:3128。简写形式 myproxy.com:3128 被视为 HTTP 代理。
  - Bypass string? （可选）
    
    可选的逗号分隔域，用于绕过代理，例如 ".com, chromium.org, .domain.com"。
  - Username string? （可选）
    
    如果 HTTP 代理需要认证，要使用的可选用户名。
  - Password string? （可选）
    
    如果 HTTP 代理需要认证，要使用的可选密码。
  网络代理设置。
- StorageState string? （可选）#
  
  使用给定的存储状态填充上下文。此选项可用于通过 BrowserContext.StorageStateAsync() 或 ApiRequestContext.StorageStateAsync() 获得的登录信息初始化上下文。可以是保存存储状态的文件的路径，也可以是 BrowserContext.StorageStateAsync() 或 ApiRequestContext.StorageStateAsync() 方法之一返回的值。
- StorageStatePath string? （可选）添加于: v1.18#
  
  使用给定的存储状态填充上下文。此选项可用于通过 BrowserContext.StorageStateAsync() 获得的登录信息初始化上下文。这是保存存储状态的文件的路径。
- Timeout [float]? （可选）#
  
  等待响应的最大时间（毫秒）。默认为 30000（30 秒）。传入 0 表示禁用超时。
- UserAgent string? （可选）#
  
  在此上下文中使用的特定用户代理。

返回值

APIRequestContext #

方法​

NewContextAsync​

方法

NewContextAsync