Web/API/Request/destination

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.

These destinations vary substantially in how they operate. Some are simply data receptacles, where the received data is stored for processing later. Others are script-based, in which case the received data is delivered to a script by calling it and passing the data along. Script-based destinations include <script> elements, as well as any of the Worklet-based destinations (including AudioWorklet and PaintWorklet), and the Worker-based destinations, including ServiceWorker and SharedWorker.

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() 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
FetchThe definition of 'destination' in that specification.	Living Standard	Initial definition

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`destination` Experimental'	Chrome Full support 65	Edge Full support 14	Firefox Full support 61	IE No support No	Opera Full support 52	Safari Full support 10.1	WebView Android Full support 65	Chrome Android Full support 65	Firefox Android Full support 61	Opera Android Full support 47	Safari iOS Full support 10.3	Samsung Internet Android Full support 9.0

Legend

Full support: Full support
No support: No support
Experimental. Expect behavior to change in the future.': Experimental. Expect behavior to change in the future.