|
3016 | 3016 | }
|
3017 | 3017 | ],
|
3018 | 3018 | "experimental": true
|
| 3019 | + }, |
| 3020 | + { |
| 3021 | + "id": "AuthChallenge", |
| 3022 | + "type": "object", |
| 3023 | + "description": "Authorization challenge for HTTP status code 401 or 407.", |
| 3024 | + "properties": [ |
| 3025 | + { |
| 3026 | + "name": "source", |
| 3027 | + "type": "string", |
| 3028 | + "optional": true, |
| 3029 | + "enum": [ |
| 3030 | + "Server", |
| 3031 | + "Proxy" |
| 3032 | + ], |
| 3033 | + "description": "Source of the authentication challenge." |
| 3034 | + }, |
| 3035 | + { |
| 3036 | + "name": "origin", |
| 3037 | + "type": "string", |
| 3038 | + "description": "Origin of the challenger." |
| 3039 | + }, |
| 3040 | + { |
| 3041 | + "name": "scheme", |
| 3042 | + "type": "string", |
| 3043 | + "description": "The authentication scheme used, such as basic or digest" |
| 3044 | + }, |
| 3045 | + { |
| 3046 | + "name": "realm", |
| 3047 | + "type": "string", |
| 3048 | + "description": "The realm of the challenge. May be empty." |
| 3049 | + } |
| 3050 | + ], |
| 3051 | + "experimental": true |
| 3052 | + }, |
| 3053 | + { |
| 3054 | + "id": "AuthChallengeResponse", |
| 3055 | + "type": "object", |
| 3056 | + "description": "Response to an AuthChallenge.", |
| 3057 | + "properties": [ |
| 3058 | + { |
| 3059 | + "name": "response", |
| 3060 | + "type": "string", |
| 3061 | + "enum": [ |
| 3062 | + "Default", |
| 3063 | + "CancelAuth", |
| 3064 | + "ProvideCredentials" |
| 3065 | + ], |
| 3066 | + "description": "The decision on what to do in response to the authorization challenge. Default means deferring to the default behavior of the net stack, which will likely either the Cancel authentication or display a popup dialog box." |
| 3067 | + }, |
| 3068 | + { |
| 3069 | + "name": "username", |
| 3070 | + "type": "string", |
| 3071 | + "optional": true, |
| 3072 | + "description": "The username to provide, possibly empty. Should only be set if response is ProvideCredentials." |
| 3073 | + }, |
| 3074 | + { |
| 3075 | + "name": "password", |
| 3076 | + "type": "string", |
| 3077 | + "optional": true, |
| 3078 | + "description": "The password to provide, possibly empty. Should only be set if response is ProvideCredentials." |
| 3079 | + } |
| 3080 | + ], |
| 3081 | + "experimental": true |
3019 | 3082 | }
|
3020 | 3083 | ],
|
3021 | 3084 | "commands": [
|
|
3396 | 3459 | "name": "errorReason",
|
3397 | 3460 | "$ref": "ErrorReason",
|
3398 | 3461 | "optional": true,
|
3399 |
| - "description": "If set this causes the request to fail with the given reason." |
| 3462 | + "description": "If set this causes the request to fail with the given reason. Must not be set in response to an authChallenge." |
3400 | 3463 | },
|
3401 | 3464 | {
|
3402 | 3465 | "name": "rawResponse",
|
3403 | 3466 | "type": "string",
|
3404 | 3467 | "optional": true,
|
3405 |
| - "description": "If set the requests completes using with the provided base64 encoded raw response, including HTTP status line and headers etc..." |
| 3468 | + "description": "If set the requests completes using with the provided base64 encoded raw response, including HTTP status line and headers etc... Must not be set in response to an authChallenge." |
3406 | 3469 | },
|
3407 | 3470 | {
|
3408 | 3471 | "name": "url",
|
3409 | 3472 | "type": "string",
|
3410 | 3473 | "optional": true,
|
3411 |
| - "description": "If set the request url will be modified in a way that's not observable by page." |
| 3474 | + "description": "If set the request url will be modified in a way that's not observable by page. Must not be set in response to an authChallenge." |
3412 | 3475 | },
|
3413 | 3476 | {
|
3414 | 3477 | "name": "method",
|
3415 | 3478 | "type": "string",
|
3416 | 3479 | "optional": true,
|
3417 |
| - "description": "If set this allows the request method to be overridden." |
| 3480 | + "description": "If set this allows the request method to be overridden. Must not be set in response to an authChallenge." |
3418 | 3481 | },
|
3419 | 3482 | {
|
3420 | 3483 | "name": "postData",
|
3421 | 3484 | "type": "string",
|
3422 | 3485 | "optional": true,
|
3423 |
| - "description": "If set this allows postData to be set." |
| 3486 | + "description": "If set this allows postData to be set. Must not be set in response to an authChallenge." |
3424 | 3487 | },
|
3425 | 3488 | {
|
3426 | 3489 | "name": "headers",
|
3427 | 3490 | "$ref": "Headers",
|
3428 | 3491 | "optional": true,
|
3429 |
| - "description": "If set this allows the request headers to be changed." |
| 3492 | + "description": "If set this allows the request headers to be changed. Must not be set in response to an authChallenge." |
| 3493 | + }, |
| 3494 | + { |
| 3495 | + "name": "authChallengeResponse", |
| 3496 | + "$ref": "AuthChallengeResponse", |
| 3497 | + "optional": true, |
| 3498 | + "description": "Response to a requestIntercepted with an authChallenge. Must not be set otherwise." |
3430 | 3499 | }
|
3431 | 3500 | ],
|
3432 | 3501 | "experimental": true
|
|
3845 | 3914 | {
|
3846 | 3915 | "name": "interceptionId",
|
3847 | 3916 | "$ref": "InterceptionId",
|
3848 |
| - "description": "Each request the page makes will have a unique id, however if any redirects are encountered while processing that fetch, they will be reported with the same id as the original fetch." |
| 3917 | + "description": "Each request the page makes will have a unique id, however if any redirects are encountered while processing that fetch, they will be reported with the same id as the original fetch. Likewise if HTTP authentication is needed then the same fetch id will be used." |
3849 | 3918 | },
|
3850 | 3919 | {
|
3851 | 3920 | "name": "request",
|
|
3873 | 3942 | "optional": true,
|
3874 | 3943 | "type": "string",
|
3875 | 3944 | "description": "Redirect location, only sent if a redirect was intercepted."
|
| 3945 | + }, |
| 3946 | + { |
| 3947 | + "name": "authChallenge", |
| 3948 | + "$ref": "AuthChallenge", |
| 3949 | + "optional": true, |
| 3950 | + "description": "Details of the Authorization Challenge encountered. If this is set then continueInterceptedRequest must contain an authChallengeResponse." |
3876 | 3951 | }
|
3877 | 3952 | ],
|
3878 | 3953 | "experimental": true
|
|
0 commit comments