harmony 鸿蒙@ohos.net.http (Data Request)
@ohos.net.http (Data Request)
The http module provides the HTTP data request capability. An application can initiate a data request over HTTP. Common HTTP methods include GET, POST, OPTIONS, HEAD, PUT, DELETE, TRACE, and CONNECT.
NOTE
The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
Modules to Import
import http from '@ohos.net.http';
Examples
// Import the http namespace.
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
// Each httpRequest corresponds to an HTTP request task and cannot be reused.
let httpRequest = http.createHttp();
// This API is used to listen for the HTTP Response Header event, which is returned earlier than the result of the HTTP request. It is up to you whether to listen for HTTP Response Header events.
// on('headerReceive', AsyncCallback) is replaced by on('headersReceive', Callback) since API version 8.
httpRequest.on('headersReceive', (header:Object) => {
console.info('header: ' + JSON.stringify(header));
});
class ExtraData {
public data: string;
constructor(data: string) {
this.data = data;
}
}
class Header {
public contentType: string;
constructor(contentType: string) {
this.contentType = contentType;
}
}
httpRequest.request(
// Customize EXAMPLE_URL in extraData on your own. It is up to you whether to add parameters to the URL.
"EXAMPLE_URL",
{
method: http.RequestMethod.POST, // Optional. The default value is http.RequestMethod.GET.
// You can add header fields based on service requirements.
header: new Header('application/json'),
// This parameter is used to transfer data when the POST request is used.
extraData: new ExtraData('data to send'),
expectDataType: http.HttpDataType.STRING, // Optional. This parameter specifies the type of the return data.
usingCache: true, // Optional. The default value is true.
priority: 1, // Optional. The default value is 1.
connectTimeout: 60000 // Optional. The default value is 60000, in ms.
readTimeout: 60000, // Optional. The default value is 60000, in ms.
usingProtocol: http.HttpProtocol.HTTP1_1, // Optional. The default protocol type is automatically specified by the system.
usingProxy: false, // Optional. By default, network proxy is not used. This field is supported since API version 10.
caPath: "", // Optional. The preset CA certificate is used by default. This field is supported since API version 10.
},
(err: BusinessError, data: http.HttpResponse ) => {
if (!err) {
// data.result carries the HTTP response. Parse the response based on service requirements.
console.info('Result:' + JSON.stringify(data.result));
console.info('code:' + JSON.stringify(data.responseCode));
// data.header carries the HTTP response header. Parse the content based on service requirements.
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + JSON.stringify(data.cookies)); // 8+
// Unsubscribe from HTTP Response Header events.
httpRequest.off('headersReceive');
// Call destroy() to destroy the JavaScript object after the HTTP request is complete.
httpRequest.destroy();
} else {
console.info('error:' + JSON.stringify(err));
// Unsubscribe from HTTP Response Header events.
httpRequest.off('headersReceive');
// Call destroy() to destroy the JavaScript object after the HTTP request is complete.
httpRequest.destroy();
}
);
NOTE If the data in console.info() contains a newline character, the data will be truncated.
http.createHttp6+
createHttp(): HttpRequest
Creates an HTTP request. You can use this API to initiate or destroy an HTTP request, or enable or disable listening for HTTP Response Header events. An HttpRequest object corresponds to an HTTP request. To initiate multiple HTTP requests, you must create an HttpRequest object for each HTTP request.
NOTE Call the destroy() method to release resources after the HttpRequest is complete.
System capability: SystemCapability.Communication.NetStack
Return value
Type | Description |
---|---|
HttpRequest | An HttpRequest object, which contains the request, requestInStream, destroy, on, or off method. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
HttpRequest
Defines an HTTP request task. Before invoking APIs provided by HttpRequest, you must call createHttp() to create an HttpRequestTask object.
request6+
request(url: string, callback: AsyncCallback<HttpResponse>):void
Initiates an HTTP request to a given URL. This API uses an asynchronous callback to return the result.
NOTE This API supports only receiving of data not greater than 5 MB.
Required permissions: ohos.permission.INTERNET
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
url | string | Yes | URL for initiating an HTTP request. |
callback | AsyncCallback<HttpResponse> | Yes | Callback used to return the result. |
Error codes
ID | Error Message |
---|---|
401 | Parameter error. |
201 | Permission denied. |
2300001 | Unsupported protocol. |
2300003 | URL using bad/illegal format or missing URL. |
2300005 | Couldn’t resolve proxy name. |
2300006 | Couldn’t resolve host name. |
2300007 | Couldn’t connect to server. |
2300008 | Weird server reply. |
2300009 | Access denied to remote resource. |
2300016 | Error in the HTTP2 framing layer. |
2300018 | Transferred a partial file. |
2300023 | Failed writing received data to disk/application. |
2300025 | Upload failed. |
2300026 | Failed to open/read local data from file/application. |
2300027 | Out of memory. |
2300028 | Timeout was reached. |
2300047 | Number of redirects hit maximum amount. |
2300052 | Server returned nothing (no headers, no data). |
2300055 | Failed sending data to the peer. |
2300056 | Failure when receiving data from the peer. |
2300058 | Problem with the local SSL certificate. |
2300059 | Couldn’t use specified SSL cipher. |
2300060 | SSL peer certificate or SSH remote key was not OK. |
2300061 | Unrecognized or bad HTTP Content or Transfer-Encoding. |
2300063 | Maximum file size exceeded. |
2300070 | Disk full or allocation exceeded. |
2300073 | Remote file already exists. |
2300077 | Problem with the SSL CA cert (path? access rights?). |
2300078 | Remote file not found. |
2300094 | An authentication function returned an error. |
2300999 | Unknown Other Error. |
NOTE For details about the error codes, see HTTP Error Codes. The HTTP error code mapping is in the format of 2300000 + Curl error code. For more common error codes, see Curl Error Codes.
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.request("EXAMPLE_URL", (err: Error, data: http.HttpResponse) => {
if (!err) {
console.info('Result:' + data.result);
console.info('code:' + data.responseCode);
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + data.cookies); // 8+
} else {
console.info('error:' + JSON.stringify(err));
}
});
request6+
request(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpResponse>):void
Initiates an HTTP request containing specified options to a given URL. This API uses an asynchronous callback to return the result.
NOTE This API supports only receiving of data not greater than 5 MB.
Required permissions: ohos.permission.INTERNET
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
url | string | Yes | URL for initiating an HTTP request. |
options | HttpRequestOptions | Yes | Request options. For details, see HttpRequestOptions. |
callback | AsyncCallback<HttpResponse> | Yes | Callback used to return the result. |
Error codes
ID | Error Message |
---|---|
401 | Parameter error. |
201 | Permission denied. |
2300001 | Unsupported protocol. |
2300003 | URL using bad/illegal format or missing URL. |
2300005 | Couldn’t resolve proxy name. |
2300006 | Couldn’t resolve host name. |
2300007 | Couldn’t connect to server. |
2300008 | Weird server reply. |
2300009 | Access denied to remote resource. |
2300016 | Error in the HTTP2 framing layer. |
2300018 | Transferred a partial file. |
2300023 | Failed writing received data to disk/application. |
2300025 | Upload failed. |
2300026 | Failed to open/read local data from file/application. |
2300027 | Out of memory. |
2300028 | Timeout was reached. |
2300047 | Number of redirects hit maximum amount. |
2300052 | Server returned nothing (no headers, no data). |
2300055 | Failed sending data to the peer. |
2300056 | Failure when receiving data from the peer. |
2300058 | Problem with the local SSL certificate. |
2300059 | Couldn’t use specified SSL cipher. |
2300060 | SSL peer certificate or SSH remote key was not OK. |
2300061 | Unrecognized or bad HTTP Content or Transfer-Encoding. |
2300063 | Maximum file size exceeded. |
2300070 | Disk full or allocation exceeded. |
2300073 | Remote file already exists. |
2300077 | Problem with the SSL CA cert (path? access rights?). |
2300078 | Remote file not found. |
2300094 | An authentication function returned an error. |
2300999 | Unknown Other Error. |
NOTE For details about the error codes, see HTTP Error Codes. The HTTP error code mapping is in the format of 2300000 + Curl error code. For more common error codes, see Curl Error Codes.
Example
import http from '@ohos.net.http';
class Header {
public contentType: string;
constructor(contentType: string) {
this.contentType = contentType;
}
}
let httpRequest = http.createHttp();
let promise = httpRequest.request("EXAMPLE_URL", {
method: http.RequestMethod.GET,
connectTimeout: 60000,
readTimeout: 60000,
header: new Header('application/json')
});
promise.then((data:http.HttpResponse) => {
console.info('Result:' + data.result);
console.info('code:' + data.responseCode);
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + data.cookies); // 8+
console.info('header.Content-Type:' + data.header);
console.info('header.Status-Line:' + data.header);
}).catch((err:Error) => {
console.info('error:' + JSON.stringify(err));
});
request6+
request(url: string, options? : HttpRequestOptions): Promise<HttpResponse>
Initiates an HTTP request containing specified options to a given URL. This API uses a promise to return the result.
NOTE This API supports only receiving of data not greater than 5 MB.
Required permissions: ohos.permission.INTERNET
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
url | string | Yes | URL for initiating an HTTP request. |
options | HttpRequestOptions | No | Request options. For details, see HttpRequestOptions. |
Return value
Type | Description |
---|---|
Promise<HttpResponse> | Promise used to return the result. |
Error codes
ID | Error Message |
---|---|
401 | Parameter error. |
201 | Permission denied. |
2300001 | Unsupported protocol. |
2300003 | URL using bad/illegal format or missing URL. |
2300005 | Couldn’t resolve proxy name. |
2300006 | Couldn’t resolve host name. |
2300007 | Couldn’t connect to server. |
2300008 | Weird server reply. |
2300009 | Access denied to remote resource. |
2300016 | Error in the HTTP2 framing layer. |
2300018 | Transferred a partial file. |
2300023 | Failed writing received data to disk/application. |
2300025 | Upload failed. |
2300026 | Failed to open/read local data from file/application. |
2300027 | Out of memory. |
2300028 | Timeout was reached. |
2300047 | Number of redirects hit maximum amount. |
2300052 | Server returned nothing (no headers, no data). |
2300055 | Failed sending data to the peer. |
2300056 | Failure when receiving data from the peer. |
2300058 | Problem with the local SSL certificate. |
2300059 | Couldn’t use specified SSL cipher. |
2300060 | SSL peer certificate or SSH remote key was not OK. |
2300061 | Unrecognized or bad HTTP Content or Transfer-Encoding. |
2300063 | Maximum file size exceeded. |
2300070 | Disk full or allocation exceeded. |
2300073 | Remote file already exists. |
2300077 | Problem with the SSL CA cert (path? access rights?). |
2300078 | Remote file not found. |
2300094 | An authentication function returned an error. |
2300999 | Unknown Other Error. |
NOTE For details about the error codes, see HTTP Error Codes. The HTTP error code mapping is in the format of 2300000 + Curl error code. For more common error codes, see Curl Error Codes.
Example
import http from '@ohos.net.http';
class Header {
public contentType: string;
constructor(contentType: string) {
this.contentType = contentType;
}
}
let httpRequest = http.createHttp();
let promise = httpRequest.request("EXAMPLE_URL", {
method: http.RequestMethod.GET,
connectTimeout: 60000,
readTimeout: 60000,
header: new Header('application/json')
});
promise.then((data:http.HttpResponse) => {
console.info('Result:' + data.result);
console.info('code:' + data.responseCode);
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + data.cookies); // 8+
console.info('header.Content-Type:' + data.header);
console.info('header.Status-Line:' + data.header);
}).catch((err:Error) => {
console.info('error:' + JSON.stringify(err));
});
destroy
destroy(): void
Destroys an HTTP request.
System capability: SystemCapability.Communication.NetStack
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.destroy();
requestInStream10+
requestInStream(url: string, callback: AsyncCallback<number>): void
Initiates an HTTP request containing specified options to a given URL. This API uses an asynchronous callback to return the result, which is a streaming response.
Required permissions: ohos.permission.INTERNET
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
url | string | Yes | URL for initiating an HTTP request. |
callback | AsyncCallback<number> | Yes | Callback used to return the result. |
Error codes
ID | Error Message |
---|---|
401 | Parameter error. |
201 | Permission denied. |
2300001 | Unsupported protocol. |
2300003 | URL using bad/illegal format or missing URL. |
2300005 | Couldn’t resolve proxy name. |
2300006 | Couldn’t resolve host name. |
2300007 | Couldn’t connect to server. |
2300008 | Weird server reply. |
2300009 | Access denied to remote resource. |
2300016 | Error in the HTTP2 framing layer. |
2300018 | Transferred a partial file. |
2300023 | Failed writing received data to disk/application. |
2300025 | Upload failed. |
2300026 | Failed to open/read local data from file/application. |
2300027 | Out of memory. |
2300028 | Timeout was reached. |
2300047 | Number of redirects hit maximum amount. |
2300052 | Server returned nothing (no headers, no data). |
2300055 | Failed sending data to the peer. |
2300056 | Failure when receiving data from the peer. |
2300058 | Problem with the local SSL certificate. |
2300059 | Couldn’t use specified SSL cipher. |
2300060 | SSL peer certificate or SSH remote key was not OK. |
2300061 | Unrecognized or bad HTTP Content or Transfer-Encoding. |
2300063 | Maximum file size exceeded. |
2300070 | Disk full or allocation exceeded. |
2300073 | Remote file already exists. |
2300077 | Problem with the SSL CA cert (path? access rights?). |
2300078 | Remote file not found. |
2300094 | An authentication function returned an error. |
2300999 | Unknown Other Error. |
NOTE For details about the error codes, see HTTP Error Codes. The HTTP error code mapping is in the format of 2300000 + Curl error code. For more common error codes, see Curl Error Codes.
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
let httpRequest = http.createHttp();
httpRequest.requestInStream("EXAMPLE_URL", (err: BusinessError, data: number) => {
if (!err) {
console.info("requestInStream OK! ResponseCode is " + JSON.stringify(data));
} else {
console.info("requestInStream ERROR : err = " + JSON.stringify(err));
}
})
requestInStream10+
requestInStream(url: string, options: HttpRequestOptions, callback: AsyncCallback<number>): void
Initiates an HTTP request containing specified options to a given URL. This API uses an asynchronous callback to return the result, which is a streaming response.
Required permissions: ohos.permission.INTERNET
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
url | string | Yes | URL for initiating an HTTP request. |
options | HttpRequestOptions | Yes | Request options. For details, see HttpRequestOptions. |
callback | AsyncCallback<number> | Yes | Callback used to return the result. |
Error codes
ID | Error Message |
---|---|
401 | Parameter error. |
201 | Permission denied. |
2300001 | Unsupported protocol. |
2300003 | URL using bad/illegal format or missing URL. |
2300005 | Couldn’t resolve proxy name. |
2300006 | Couldn’t resolve host name. |
2300007 | Couldn’t connect to server. |
2300008 | Weird server reply. |
2300009 | Access denied to remote resource. |
2300016 | Error in the HTTP2 framing layer. |
2300018 | Transferred a partial file. |
2300023 | Failed writing received data to disk/application. |
2300025 | Upload failed. |
2300026 | Failed to open/read local data from file/application. |
2300027 | Out of memory. |
2300028 | Timeout was reached. |
2300047 | Number of redirects hit maximum amount. |
2300052 | Server returned nothing (no headers, no data). |
2300055 | Failed sending data to the peer. |
2300056 | Failure when receiving data from the peer. |
2300058 | Problem with the local SSL certificate. |
2300059 | Couldn’t use specified SSL cipher. |
2300060 | SSL peer certificate or SSH remote key was not OK. |
2300061 | Unrecognized or bad HTTP Content or Transfer-Encoding. |
2300063 | Maximum file size exceeded. |
2300070 | Disk full or allocation exceeded. |
2300073 | Remote file already exists. |
2300077 | Problem with the SSL CA cert (path? access rights?). |
2300078 | Remote file not found. |
2300094 | An authentication function returned an error. |
2300999 | Unknown Other Error. |
NOTE For details about the error codes, see HTTP Error Codes. The HTTP error code mapping is in the format of 2300000 + Curl error code. For more common error codes, see Curl Error Codes.
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
class Header {
public contentType: string;
constructor(contentType: string) {
this.contentType = contentType;
}
}
let httpRequest = http.createHttp();
httpRequest.requestInStream("EXAMPLE_URL", (err: BusinessError<void> , data: number) => {
if (!err) {
console.info("requestInStream OK! ResponseCode is " + JSON.stringify(data));
} else {
console.info("requestInStream ERROR : err = " + JSON.stringify(err));
}
})
requestInStream10+
requestInStream(url: string, options? : HttpRequestOptions): Promise<number>
Initiates an HTTP request containing specified options to a given URL. This API uses a promise to return the result, which is a streaming response.
Required permissions: ohos.permission.INTERNET
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
url | string | Yes | URL for initiating an HTTP request. |
options | HttpRequestOptions | No | Request options. For details, see HttpRequestOptions. |
Return value
Type | Description |
---|---|
Promise<number> | Promise used to return the result. |
Error codes
ID | Error Message |
---|---|
401 | Parameter error. |
201 | Permission denied. |
2300001 | Unsupported protocol. |
2300003 | URL using bad/illegal format or missing URL. |
2300005 | Couldn’t resolve proxy name. |
2300006 | Couldn’t resolve host name. |
2300007 | Couldn’t connect to server. |
2300008 | Weird server reply. |
2300009 | Access denied to remote resource. |
2300016 | Error in the HTTP2 framing layer. |
2300018 | Transferred a partial file. |
2300023 | Failed writing received data to disk/application. |
2300025 | Upload failed. |
2300026 | Failed to open/read local data from file/application. |
2300027 | Out of memory. |
2300028 | Timeout was reached. |
2300047 | Number of redirects hit maximum amount. |
2300052 | Server returned nothing (no headers, no data). |
2300055 | Failed sending data to the peer. |
2300056 | Failure when receiving data from the peer. |
2300058 | Problem with the local SSL certificate. |
2300059 | Couldn’t use specified SSL cipher. |
2300060 | SSL peer certificate or SSH remote key was not OK. |
2300061 | Unrecognized or bad HTTP Content or Transfer-Encoding. |
2300063 | Maximum file size exceeded. |
2300070 | Disk full or allocation exceeded. |
2300073 | Remote file already exists. |
2300077 | Problem with the SSL CA cert (path? access rights?). |
2300078 | Remote file not found. |
2300094 | An authentication function returned an error. |
2300999 | Unknown Other Error. |
NOTE For details about the error codes, see HTTP Error Codes. The HTTP error code mapping is in the format of 2300000 + Curl error code. For more common error codes, see Curl Error Codes.
Example
import http from '@ohos.net.http';
class Header {
public contentType: string;
constructor(contentType: string) {
this.contentType = contentType;
}
}
let httpRequest = http.createHttp();
let promise = httpRequest.request("EXAMPLE_URL", {
method: http.RequestMethod.GET,
connectTimeout: 60000,
readTimeout: 60000,
header: new Header('application/json')
});
promise.then((data: http.HttpResponse) => {
console.info("requestInStream OK!" + JSON.stringify(data));
}).catch((err: Error) => {
console.info("requestInStream ERROR : err = " + JSON.stringify(err));
});
on(‘headerReceive’)(deprecated)
on(type: ‘headerReceive’, callback: AsyncCallback<Object>): void
Registers an observer for HTTP Response Header events.
NOTE This API has been deprecated. You are advised to use on(‘headersReceive’)8+.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is headerReceive. |
callback | AsyncCallback<Object> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
let httpRequest = http.createHttp();
httpRequest.on('headerReceive', (data: BusinessError) => {
console.info('error:' + JSON.stringify(data));
});
off(‘headerReceive’)(deprecated)
off(type: ‘headerReceive’, callback?: AsyncCallback<Object>): void
Unregisters the observer for HTTP Response Header events.
NOTE
This API has been deprecated. You are advised to use off(‘headersReceive’)8+.
You can pass the callback of the on function if you want to cancel listening for a certain type of event. If you do not pass the callback, you will cancel listening for all events.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is headerReceive. |
callback | AsyncCallback<Object> | No | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.off('headerReceive');
on(‘headersReceive’)8+
on(type: ‘headersReceive’, callback: Callback<Object>): void
Registers an observer for HTTP Response Header events.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is headersReceive. |
callback | Callback<Object> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.on('headersReceive', (header: Object) => {
console.info('header: ' + JSON.stringify(header));
});
off(‘headersReceive’)8+
off(type: ‘headersReceive’, callback?: Callback<Object>): void
Unregisters the observer for HTTP Response Header events.
NOTE You can pass the callback of the on function if you want to cancel listening for a certain type of event. If you do not pass the callback, you will cancel listening for all events.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is headersReceive. |
callback | Callback<Object> | No | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.off('headersReceive');
once(‘headersReceive’)8+
once(type: ‘headersReceive’, callback: Callback<Object>): void
Registers a one-time observer for HTTP Response Header events. Once triggered, the observer will be removed. This API uses an asynchronous callback to return the result.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is headersReceive. |
callback | Callback<Object> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.once('headersReceive', (header: Object) => {
console.info('header: ' + JSON.stringify(header));
});
on(‘dataReceive’)10+
on(type: ‘dataReceive’, callback: Callback<ArrayBuffer>): void
Registers an observer for events indicating receiving of HTTP streaming responses.
NOTE Currently, listening for events related to HTTP streaming data upload is not supported.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is dataReceive. |
callback | AsyncCallback<ArrayBuffer> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.on('dataReceive', (data: ArrayBuffer) => {
console.info('dataReceive length: ' + JSON.stringify(data.byteLength));
});
off(‘dataReceive’)10+
off(type: ‘dataReceive’, callback?: Callback<ArrayBuffer>): void
Unregisters the observer for events indicating receiving of HTTP streaming responses.
NOTE You can pass the callback of the on function if you want to cancel listening for a certain type of event. If you do not pass the callback, you will cancel listening for all events.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is dataReceive. |
callback | Callback<ArrayBuffer> | No | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.off('dataReceive');
on(‘dataEnd’)10+
on(type: ‘dataEnd’, callback: Callback<void>): void
Registers an observer for events indicating completion of receiving HTTP streaming responses.
NOTE Currently, listening for events related to HTTP streaming data upload is not supported.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is dataEnd. |
callback | AsyncCallback<void> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.on('dataEnd', () => {
console.info('Receive dataEnd !');
});
off(‘dataEnd’)10+
off(type: ‘dataEnd’, callback?: Callback<void>): void
Unregisters the observer for events indicating completion of receiving HTTP streaming responses.
NOTE You can pass the callback of the on function if you want to cancel listening for a certain type of event. If you do not pass the callback, you will cancel listening for all events.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is dataEnd. |
callback | Callback<void> | No | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.off('dataEnd');
on(‘dataReceiveProgress’)10+
on(type: ‘dataReceiveProgress’, callback: Callback<{ receiveSize: number, totalSize: number }>): void
Registers an observer for events indicating progress of receiving HTTP streaming responses.
NOTE Currently, listening for events related to HTTP streaming data upload is not supported.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is dataReceiveProgress. |
callback | AsyncCallback<{ receiveSize: number, totalSize: number }> | Yes | Callback used to return the result. - receiveSize: number of received bytes. - totalSize: total number of bytes to be received. |
Example
import http from '@ohos.net.http';
class RequestData{
receiveSize: number = 2000
totalSize: number = 2000
}
let httpRequest = http.createHttp();
httpRequest.on('dataReceiveProgress', (data: RequestData) => {
console.info('dataReceiveProgress:' + JSON.stringify(data));
});
off(‘dataReceiveProgress’)10+
off(type: ‘dataReceiveProgress’, callback?: Callback<{ receiveSize: number, totalSize: number }>): void
Unregisters the observer for events indicating progress of receiving HTTP streaming responses.
NOTE You can pass the callback of the on function if you want to cancel listening for a certain type of event. If you do not pass the callback, you will cancel listening for all events.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is dataReceiveProgress. |
callback | Callback<{ receiveSize: number, totalSize: number }> | No | Callback used to return the result. |
Example
import http from '@ohos.net.http';
let httpRequest = http.createHttp();
httpRequest.off('dataReceiveProgress');
HttpRequestOptions6+
Specifies the type and value range of the optional parameters in the HTTP request.
System capability: SystemCapability.Communication.NetStack
Name | Type | Mandatory | Description |
---|---|---|---|
method | RequestMethod | No | Request method. The default value is GET. |
extraData | string6+ |Object6+ |ArrayBuffer8+ | No | Additional data for sending a request. This parameter is not used by default. - If the HTTP request uses a POST or PUT method, this field serves as the content of the HTTP request and is encoded in UTF-8 format. If Content-Type is application/x-www-form-urlencoded, the data in the request body must be encoded in the format of key1=value1&key2=value2&key3=value3 after URL transcoding and this field is usually in the String format. If Content-Type is text/xml, this field is usually in the String format. If Content-Type is application/json, this field is usually in the Object format. If Content-Type is application/octet-stream, this field is usually in the ArrayBuffer format. If Content-Type is multipart/form-data and the content to be uploaded is a file, this field is usually in the ArrayBuffer format. The preceding information is for reference only and may vary according to the actual situation. - If the HTTP request uses the GET, OPTIONS, DELETE, TRACE, or CONNECT method, this parameter serves as a supplement to HTTP request parameters. Parameters of the string type need to be encoded before being passed to the HTTP request. Parameters of the object type do not need to be precoded and will be directly concatenated to the URL. Parameters of the ArrayBuffer type will not be concatenated to the URL. |
expectDataType9+ | HttpDataType | No | Type of the returned data. This parameter is not used by default. If this parameter is set, the system returns the specified type of data preferentially. |
usingCache9+ | boolean | No | Whether to use the cache. The default value is true. |
priority9+ | number | No | Priority. The value range is [1,1000]. The default value is 1. |
header | Object | No | HTTP request header. The default value is {‘Content-Type’: ‘application/json’}. |
readTimeout | number | No | Read timeout duration. The default value is 60000, in ms. The value 0 indicates no timeout. |
connectTimeout | number | No | Connection timeout interval. The default value is 60000, in ms. |
usingProtocol9+ | HttpProtocol | No | Protocol. The default value is automatically specified by the system. |
usingProxy10+ | boolean |Object | No | Whether to use HTTP proxy. The default value is false, which means not to use HTTP proxy. - If usingProxy is of the Boolean type and the value is true, network proxy is used by default. - If usingProxy is of the object type, the specified network proxy is used. |
caPath10+ | string | No | Path of CA certificates. If a path is set, the system uses the CA certificates in this path. If a path is not set, the system uses the preset CA certificate, namely, /etc/ssl/certs/cacert.pem. This path is the sandbox mapping path, which can be obtained through Global.getContext().filesDir. Currently, only .pem certificates are supported. |
RequestMethod6+
Defines an HTTP request method.
System capability: SystemCapability.Communication.NetStack
Name | Value | Description |
---|---|---|
OPTIONS | “OPTIONS” | OPTIONS method. |
GET | “GET” | GET method. |
HEAD | “HEAD” | HEAD method. |
POST | “POST” | POST method. |
PUT | “PUT” | PUT method. |
DELETE | “DELETE” | DELETE method. |
TRACE | “TRACE” | TRACE method. |
CONNECT | “CONNECT” | CONNECT method. |
ResponseCode6+
Enumerates the response codes for an HTTP request.
System capability: SystemCapability.Communication.NetStack
Name | Value | Description |
---|---|---|
OK | 200 | The request is successful. The request has been processed successfully. This return code is generally used for GET and POST requests. |
CREATED | 201 | “Created.” The request has been successfully sent and a new resource is created. |
ACCEPTED | 202 | “Accepted.” The request has been accepted, but the processing has not been completed. |
NOT_AUTHORITATIVE | 203 | “Non-Authoritative Information.” The request is successful. |
NO_CONTENT | 204 | “No Content.” The server has successfully fulfilled the request but there is no additional content to send in the response payload body. |
RESET | 205 | “Reset Content.” The server has successfully fulfilled the request and desires that the user agent reset the content. |
PARTIAL | 206 | “Partial Content.” The server has successfully fulfilled the partial GET request for a given resource. |
MULT_CHOICE | 300 | “Multiple Choices.” The requested resource corresponds to any one of a set of representations. |
MOVED_PERM | 301 | “Moved Permanently.” The requested resource has been assigned a new permanent URI and any future references to this resource will be redirected to this URI. |
MOVED_TEMP | 302 | “Moved Temporarily.” The requested resource is moved temporarily to a different URI. |
SEE_OTHER | 303 | “See Other.” The response to the request can be found under a different URI. |
NOT_MODIFIED | 304 | “Not Modified.” The client has performed a conditional GET request and access is allowed, but the content has not been modified. |
USE_PROXY | 305 | “Use Proxy.” The requested resource can only be accessed through the proxy. |
BAD_REQUEST | 400 | “Bad Request.” The request could not be understood by the server due to incorrect syntax. |
UNAUTHORIZED | 401 | “Unauthorized.” The request requires user authentication. |
PAYMENT_REQUIRED | 402 | “Payment Required.” This code is reserved for future use. |
FORBIDDEN | 403 | “Forbidden.” The server understands the request but refuses to process it. |
NOT_FOUND | 404 | “Not Found.” The server does not find anything matching the Request-URI. |
BAD_METHOD | 405 | “Method Not Allowed.” The method specified in the request is not allowed for the resource identified by the Request-URI. |
NOT_ACCEPTABLE | 406 | “Not Acceptable.” The server cannot fulfill the request according to the content characteristics of the request. |
PROXY_AUTH | 407 | “Proxy Authentication Required.” The request requires user authentication with the proxy. |
CLIENT_TIMEOUT | 408 | “Request Timeout.” The client fails to generate a request within the timeout period. |
CONFLICT | 409 | “Conflict.” The request cannot be fulfilled due to a conflict with the current state of the resource. Conflicts are most likely to occur in response to a PUT request. |
GONE | 410 | “Gone.” The requested resource has been deleted permanently and is no longer available. |
LENGTH_REQUIRED | 411 | “Length Required.” The server refuses to process the request without a defined Content-Length. |
PRECON_FAILED | 412 | “Precondition Failed.” The precondition in the request is incorrect. |
ENTITY_TOO_LARGE | 413 | “Request Entity Too Large.” The server refuses to process a request because the request entity is larger than the server is able to process. |
REQ_TOO_LONG | 414 | “Request-URI Too Long.” The Request-URI is too long for the server to process. |
UNSUPPORTED_TYPE | 415 | “Unsupported Media Type.” The server is unable to process the media format in the request. |
INTERNAL_ERROR | 500 | “Internal Server Error.” The server encounters an unexpected error that prevents it from fulfilling the request. |
NOT_IMPLEMENTED | 501 | “Not Implemented.” The server does not support the function required to fulfill the request. |
BAD_GATEWAY | 502 | “Bad Gateway.” The server acting as a gateway or proxy receives an invalid response from the upstream server. |
UNAVAILABLE | 503 | “Service Unavailable.” The server is currently unable to process the request due to a temporary overload or system maintenance. |
GATEWAY_TIMEOUT | 504 | “Gateway Timeout.” The server acting as a gateway or proxy does not receive requests from the remote server within the timeout period. |
VERSION | 505 | “HTTP Version Not Supported.” The server does not support the HTTP protocol version used in the request. |
HttpResponse6+
Defines the response to an HTTP request.
System capability: SystemCapability.Communication.NetStack
Name | Type | Mandatory | Description |
---|---|---|---|
result | string6+ |Objectdeprecated 8+ |ArrayBuffer8+ | Yes | Response content returned based on Content-type in the response header. If HttpRequestOptions does not contain the expectDataType field, the response content is returned according to the following rules: - application/json: string in JSON format - application/octet-stream: ArrayBuffer - image: ArrayBuffer - Others: string If HttpRequestOptions contains the expectDataType field, the response content must be of the same type as the data returned by the server. |
resultType9+ | HttpDataType | Yes | Type of the return value. |
responseCode | ResponseCode |number | Yes | Result code for an HTTP request. If the callback function is successfully executed, a result code defined in ResponseCode will be returned. Otherwise, an error code will be returned in the err field in AsyncCallback. |
header | Object | Yes | Response header. The return value is a string in JSON format. If you want to use specific content in the response, you need to implement parsing of that content. Common fields and parsing methods are as follows: - content-type: header[‘content-type’]; - status-line: header[‘status-line’]; - date: header.date/header[‘date’]; - server: header.server/header[‘server’]; |
cookies8+ | string | Yes | Cookies returned by the server. |
http.createHttpResponseCache9+
createHttpResponseCache(cacheSize?: number): HttpResponseCache
Creates a default object to store responses to HTTP access requests.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
cacheSize | number | No | Cache size. The maximum value is 10*1024*1024 (10 MB). By default, the maximum value is used. |
Return value
Type | Description |
---|---|
HttpResponseCache | Object that stores the response to the HTTP request. |
Example
import http from '@ohos.net.http';
let httpResponseCache = http.createHttpResponseCache();
HttpResponseCache9+
Defines an object that stores the response to an HTTP request. Before invoking APIs provided by HttpResponseCache, you must call createHttpResponseCache() to create an HttpRequestTask object.
flush9+
flush(callback: AsyncCallback<void>): void
Flushes data in the cache to the file system so that the cached data can be accessed in the next HTTP request. This API uses an asynchronous callback to return the result. Cached data includes the response header (header), response body (result), cookies, request time (requestTime), and response time (responseTime).
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | AsyncCallback<void> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
let httpResponseCache = http.createHttpResponseCache();
httpResponseCache.flush((err: BusinessError) => {
if (err) {
console.info('flush fail');
return;
}
console.info('flush success');
});
flush9+
flush(): Promise<void>
Flushes data in the cache to the file system so that the cached data can be accessed in the next HTTP request. This API uses a promise to return the result.
System capability: SystemCapability.Communication.NetStack
Return value
Type | Description |
---|---|
Promise<void> | Promise used to return the result. |
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
let httpResponseCache = http.createHttpResponseCache();
httpResponseCache.flush().then(() => {
console.info('flush success');
}).catch((err: BusinessError) => {
console.info('flush fail');
});
delete9+
delete(callback: AsyncCallback<void>): void
Disables the cache and deletes the data in it. This API uses an asynchronous callback to return the result.
System capability: SystemCapability.Communication.NetStack
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | AsyncCallback<void> | Yes | Callback used to return the result. |
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
let httpResponseCache = http.createHttpResponseCache();
httpResponseCache.delete((err: BusinessError) => {
if (err) {
console.info('delete fail');
return;
}
console.info('delete success');
});
delete9+
delete(): Promise<void>
Disables the cache and deletes the data in it. This API uses a promise to return the result.
System capability: SystemCapability.Communication.NetStack
Return value
Type | Description |
---|---|
Promise<void> | Promise used to return the result. |
Example
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
let httpResponseCache = http.createHttpResponseCache();
httpResponseCache.delete().then(() => {
console.info('delete success');
}).catch((err: Error) => {
console.info('delete fail');
});
HttpDataType9+
Enumerates HTTP data types.
System capability: SystemCapability.Communication.NetStack
|Name|Value|Description | |——————|–|———–| |STRING |0|String type.| |OBJECT |1|Object type. | |ARRAY_BUFFER |2|Binary array type.|
HttpProtocol9+
Enumerates HTTP protocol versions.
System capability: SystemCapability.Communication.NetStack
Name | Description |
---|---|
HTTP1_1 | HTTP1.1 |
HTTP2 | HTTP2 |
你可能感兴趣的鸿蒙文章
harmony 鸿蒙System Common Events (To Be Deprecated Soon)
harmony 鸿蒙System Common Events
harmony 鸿蒙API Reference Document Description
harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)
harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)
harmony 鸿蒙@ohos.bundle (Bundle)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦