Request.destination

我们的志愿者还没有将这篇文章翻译为 中文 (简体)加入我们帮助完成翻译
您也可以阅读此文章的English (US)版。

The destination read-only property of the Request interface returns a string describing the type of content being requested. The string must be one of those found in the RequestDestination enumerated type or the empty string, which is the default value.

The destination is used by the user agent to, for example, help determine which set of rules to follow for CORS purposes, or how to navigate any complicated code paths that affect how specific types of request get handled.

Syntax

var destination = request.destination;

Value

A string from the RequestDestination enumerated type which indicates the type of content the request is asking for. This type is much broader than the usual document type values (such as "document" or "manifest"), and may include contextual cues such as "image" or "worker" or "audioworklet".

Example

In the following snippet, we create a new request using the Request.Request() constructor (for an image file in the same directory as the script), then save the request's destination:

var myRequest = new Request('flowers.jpg');
var myDestination = myRequest.destination; // returns the empty string by default

Specifications

Specification Status Comment
Fetch
The definition of 'destination' in that specification.
Living Standard Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
destination
Experimental
Chrome Full support 65Edge Full support 14Firefox Full support 61IE No support NoOpera Full support 52Safari Full support 10.1WebView Android Full support 65Chrome Android Full support 65Edge Mobile ? Firefox Android Full support 61Opera Android Full support 47Safari iOS Full support 10.1Samsung Internet Android Full support Yes

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

See also

文档标签和贡献者

此页面的贡献者: mdnwebdocs-bot, mfluehr, ExE-Boss, Sheppy
最后编辑者: mdnwebdocs-bot,