request 静态方法

String url, {
String? method,
bool? withCredentials,
String? responseType,
String? mimeType,
Map<String, String>? requestHeaders,
dynamic sendData,
void onProgress(
1. ProgressEvent e
)?,

})

创建并发送指定 url 的 URL 请求。

默认情况下，request 将执行 HTTP GET 请求，但可以通过指定 method 参数使用不同的方法（如 POST、PUT、DELETE 等）。（有关 POST 请求的更多信息，请参阅 HttpRequest.postFormData。

当响应可用时，Future 完成。

如果指定，sendData 将以 ByteBuffer、Blob、Document、String 或 FormData 的形式发送数据，并与 HttpRequest 一起发送。

如果指定，responseType 设置请求所需的响应格式。默认情况下它是 String，但也可以是 'arraybuffer'、'blob'、'document'、'json' 或 'text'。有关更多信息，请参阅 HttpRequest.responseType。

withCredentials 参数指定应指定请求的凭据，如已设置在标题中的 cookie 或授权标题。在使用凭据时要注意的细节

使用凭据仅对跨源请求有用。
url 的 Access-Control-Allow-Origin 标题不能包含通配符 (*)。
url 的 Access-Control-Allow-Credentials 标题必须设置为 true。
如果未将 Access-Control-Expose-Headers 设置为 true，则在调用 getAllResponseHeaders 时，只会返回所有响应标题的一个子集。

以下与上面的 getString 示例等效

var name = Uri.encodeQueryComponent('John');
var id = Uri.encodeQueryComponent('42');
HttpRequest.request('users.json?name=$name&id=$id')
  .then((HttpRequest resp) {
    // Do something with the response.
});

以下是一个使用 FormData 提交整个表单的示例。

var myForm = querySelector('form#myForm');
var data = new FormData(myForm);
HttpRequest.request('/submit', method: 'POST', sendData: data)
  .then((HttpRequest resp) {
    // Do something with the response.
});

请注意，仅支持具有适当权限的 Chrome 扩展程序中的 file:// URI 请求。对 file:// URI 的请求也永远不会失败 - Future 总是成功完成，即使找不到文件。

参见：授权头。

实现

static Future<HttpRequest> request(String url,
    {String? method,
    bool? withCredentials,
    String? responseType,
    String? mimeType,
    Map<String, String>? requestHeaders,
    sendData,
    void onProgress(ProgressEvent e)?}) {
  var completer = new Completer<HttpRequest>();

  var xhr = new HttpRequest();
  if (method == null) {
    method = 'GET';
  }
  xhr.open(method, url, async: true);

  if (withCredentials != null) {
    xhr.withCredentials = withCredentials;
  }

  if (responseType != null) {
    xhr.responseType = responseType;
  }

  if (mimeType != null) {
    xhr.overrideMimeType(mimeType);
  }

  if (requestHeaders != null) {
    requestHeaders.forEach((header, value) {
      xhr.setRequestHeader(header, value);
    });
  }

  if (onProgress != null) {
    xhr.onProgress.listen(onProgress);
  }

  xhr.onLoad.listen((e) {
    var status = xhr.status!;
    var accepted = status >= 200 && status < 300;
    var fileUri = status == 0; // file:// URIs have status of 0.
    var notModified = status == 304;
    // Redirect status is specified up to 307, but others have been used in
    // practice. Notably Google Drive uses 308 Resume Incomplete for
    // resumable uploads, and it's also been used as a redirect. The
    // redirect case will be handled by the browser before it gets to us,
    // so if we see it we should pass it through to the user.
    var unknownRedirect = status > 307 && status < 400;

    if (accepted || fileUri || notModified || unknownRedirect) {
      completer.complete(xhr);
    } else {
      completer.completeError(e);
    }
  });

  xhr.onError.listen(completer.completeError);

  if (sendData != null) {
    xhr.send(sendData);
  } else {
    xhr.send();
  }

  return completer.future;
}

request 静态方法

实现

HttpRequest 类