declarativeNetRequest.Redirect
Details describing how a redirect should be performed, as the redirect
property of a RuleAction
. Only valid for redirect rules.
Note: A redirect action does not redirect the request, and the request continues as usual when:
- the action does not change the request.
- the redirect URL is invalid (e.g., the value of
regexSubstitution
is not a valid URL).
Type
Values of this type are objects. They contain these properties:
extensionPath
Optional-
A
string
. The path relative to the extension directory. Should start with '/'. The initiator of the request can only follow the redirect when the resource is listed inweb_accessible_resources
. regexSubstitution
Optional-
A
string
. The substitution pattern for rules that specify aregexFilter
. The first match ofregexFilter
within the URL is replaced with this pattern. WithinregexSubstitution
, backslash-escaped digits (\1
to\9
) are used to insert the corresponding capture groups.\0
refers to the entire matching text. transform
Optional-
declarativeNetRequest.URLTransform
. The URL transformations to perform. url
Optional-
A
string
. The redirect URL. Redirects to JavaScript URLs are not allowed.
Example extensions
Browser compatibility
BCD tables only load in the browser