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 を考慮に入れます。例
  - baseURL: http://localhost:3000 で /bar.html にリクエストを送信すると、http://localhost:3000/bar.html になります。
  - baseURL: http://localhost:3000/foo/ で ./bar.html にリクエストを送信すると、http://localhost:3000/foo/bar.html になります。
  - baseURL: 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 ヘッダーを含むオブジェクト。デフォルトは none です。
- FailOnStatusCode bool? (オプション)v1.51 で追加#
  
  2xx および 3xx 以外のレスポンスコードで例外をスローするかどうか。デフォルトでは、すべてのステータスコードに対してレスポンスオブジェクトが返されます。
- HttpCredentials HttpCredentials? (オプション)#
  - Username string
  - Password string
  - Origin string? (オプション)
    
    特定のオリジン (scheme://host:port).
  - Send enum HttpCredentialsSend { Unauthorized, Always }? (オプション)
    
    このオプションは、対応する APIRequestContext から送信されたリクエストにのみ適用され、ブラウザから送信されたリクエストには影響しません。'always' - 基本認証クレデンシャルを含む Authorization ヘッダーが、各 API リクエストとともに送信されます。'unauthorized - クレデンシャルは、WWW-Authenticate ヘッダーを含む 401 (Unauthorized) レスポンスを受信した場合にのみ送信されます。デフォルトは 'unauthorized' です。
  HTTP 認証のクレデンシャル。オリジンが指定されていない場合、ユーザー名とパスワードは、認証されていないレスポンスで任意のサーバーに送信されます。
- IgnoreHTTPSErrors bool? (オプション)#
  
  ネットワークリクエストの送信時に HTTPS エラーを無視するかどうか。デフォルトは false です。
- 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