Request()构造函数

在Body接口中，该Request()构造函数用来创建一个新的Request对象。

Request() 语法

var myRequest = new Request（input，init）;

Request() 参数

input

定义您想要获取的资源。这可以是：

• 一个USVString包含要获取资源的直接URL。
• 一个Request对象，有效地创建一个副本。请注意以下操作更新以保持安全性，同时使构造函数不太可能抛出异常：
  • 如果这个对象存在于构造函数调用的另一个起源中，则将Request.referrer除去。
  • 如果该对象具有navigate的Request.mode，该mode值被转换为same-origin。

init（可选的）

包含要应用于请求的任何自定义设置的选项对象。可能的选项是：

• method：请求方法，例如GET，POST。
• headers：你想添加到你的请求的任何头文件，包含在一个Headers对象或带有ByteString值的对象文本中。
• body：您要添加到您的请求的任何body：这可以是一个Blob，BufferSource，FormData，URLSearchParams，USVString或ReadableStream对象。请注意，使用GET或者HEAD方法的请求不能有一个主体。
• mode：您要使用该请求的模式，例如cors，no-cors，same-origin或navigate，默认是cors。在Chrome中，默认情况下是no-cors在Chrome 47之前，same-origin从Chrome 47开始。
• credentials：请求凭据要使用的要求：omit，same-origin或include。默认是omit。在Chrome中，默认情况下是same-origin在Chrome 47之前，从Chrome 47开始默认为include。
• cache：您想要用于请求的缓存模式。
• redirect：要使用的Redirect方式：follow，error或manual。在Chrome中，默认情况下是manual在Chrome 47之前，从Chrome 47开始默认为follow。
• referrer：USVString指定no-referrer，client或URL；默认是client。
• integrity：包含请求的子资源完整性值（例如，sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=）。

异常错误

Request() 构造函数示例

在我们的Fetch Request示例中（请参阅“Fetch Request live”），我们使用构造函数创建一个新的Request对象，然后使用GlobalFetch.fetch调用来获取它。由于我们正在获取图像，因此我们在响应上运行Body.blob以提供适当的MIME类型，以便正确处理，然后创建一个Object URL并将其显示在<img>元素中。

var myImage = document.querySelector('img');

var myRequest = new Request('flowers.jpg');

fetch(myRequest).then(function(response) {
  return response.blob();
}).then(function(response) {
  var objectURL = URL.createObjectURL(response);
  myImage.src = objectURL;
});

在我们的带有init例子的Fetch Request中（请参阅Fetch Request init live），我们做同样的事情，只不过我们在调用fetch()时传入init对象：

var myImage = document.querySelector('img');

var myHeaders = new Headers();
myHeaders.append('Content-Type', 'image/jpeg');

var myInit = { method: 'GET',
               headers: myHeaders,
               mode: 'cors',
               cache: 'default' };

var myRequest = new Request('flowers.jpg',myInit);

fetch(myRequest).then(function(response) {
  ... 
});

请注意，您也可以将init对象传递给fetch调用以获得相同的效果，例如：

fetch(myRequest,myInit).then(function(response) {
  ...
});

您还可以在init中使用对象文本作为headers。

var myInit = { method: 'GET',
               headers: {
                   'Content-Type': 'image/jpeg'
               },
               mode: 'cors',
               cache: 'default' };

var myRequest = new Request('flowers.jpg', myInit);

您也可以将一个Request对象传递给Request()构造函数来创建请求的副本（这与调用clone()方法类似）。

var copy = new Request(myRequest);

注意：这最后一个用法可能只在ServiceWorkers中有用。

规范

浏览器兼容性

• 电脑端

• 移动端

[1] 在Chrome 47中初始化参数的某些默认值已更改。有关详细信息，请参阅“属性（Properties）”部分。

[2]在版本34的首选项后。 

[3]在版本28的首选项后。 

[4]可读流当前在Firefox中启用，但隐藏在dom.streams.enabled和javascript.options.streamsprefs 后面。