title: stream type: references group: Build-in Modules order: 9.10 version: 2.1

stream

A series of stream api. It provides a network request.

API

fetch(options, callback,progressCallback)

Start a network request, use two callbacks to receive server's response data.

Arguments

  • options(object): the request options, key value style dictionary.

    • method(string): the HTTP method GET or POST.

    • url(string): the request url.

    • headers(string): the HTTP request headers.

    • type(string): response type, ‘json’,‘text’ or ‘jsonp’(same as ‘json’ in native implementation)

    • body(string): the HTTP body.

  • callback(function): A callback function whose argument is the response object of the request. Callback function will receive a response object.

    • status(number): response status code.

    • ok(boolean): true if status code is bewteen 200~299.

    • statusText(string): status text

    • data(string): response data. It's a object if request option is json/jsonp, or (string) in other type value.

    • headers(object): response headers

  • progressCallback(function): A progress callback. This callback will be invoked before request finished.

    • readyState(number): Current request state.‘1’:request connection opened;‘2’:response headers received.;‘3’:response data is loading;

    • status(number): response status code.

    • length(number): bytes of data have received. You can read full length of response from ‘headers’.

    • statusText(string): status text.

    • headers(object): response headers.

Note

  • Default Content-Type is ‘application/x-www-form-urlencoded’. (The type specified in fetch is the response type!)
  • You need to set the Content-Type header to ‘application/json’ manually if you want to post the json body.

Example

stream demo