105 lines
2.8 KiB
TypeScript
105 lines
2.8 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {stringToArrayBuffer} from './http_utils';
|
|
import {URLSearchParams} from './url_search_params';
|
|
|
|
|
|
/**
|
|
* HTTP request body used by both {@link Request} and {@link Response}
|
|
* https://fetch.spec.whatwg.org/#body
|
|
*/
|
|
export abstract class Body {
|
|
/**
|
|
* @internal
|
|
*/
|
|
protected _body: any;
|
|
|
|
/**
|
|
* Attempts to return body as parsed `JSON` object, or raises an exception.
|
|
*/
|
|
json(): any {
|
|
if (typeof this._body === 'string') {
|
|
return JSON.parse(this._body);
|
|
}
|
|
|
|
if (this._body instanceof ArrayBuffer) {
|
|
return JSON.parse(this.text());
|
|
}
|
|
|
|
return this._body;
|
|
}
|
|
|
|
/**
|
|
* Returns the body as a string, presuming `toString()` can be called on the response body.
|
|
*
|
|
* When decoding an `ArrayBuffer`, the optional `encodingHint` parameter determines how the
|
|
* bytes in the buffer will be interpreted. Valid values are:
|
|
*
|
|
* - `legacy` - incorrectly interpret the bytes as UTF-16 (technically, UCS-2). Only characters
|
|
* in the Basic Multilingual Plane are supported, surrogate pairs are not handled correctly.
|
|
* In addition, the endianness of the 16-bit octet pairs in the `ArrayBuffer` is not taken
|
|
* into consideration. This is the default behavior to avoid breaking apps, but should be
|
|
* considered deprecated.
|
|
*
|
|
* - `iso-8859` - interpret the bytes as ISO-8859 (which can be used for ASCII encoded text).
|
|
*/
|
|
text(encodingHint: 'legacy'|'iso-8859' = 'legacy'): string {
|
|
if (this._body instanceof URLSearchParams) {
|
|
return this._body.toString();
|
|
}
|
|
|
|
if (this._body instanceof ArrayBuffer) {
|
|
switch (encodingHint) {
|
|
case 'legacy':
|
|
return String.fromCharCode.apply(null, new Uint16Array(this._body));
|
|
case 'iso-8859':
|
|
return String.fromCharCode.apply(null, new Uint8Array(this._body));
|
|
default:
|
|
throw new Error(`Invalid value for encodingHint: ${encodingHint}`);
|
|
}
|
|
}
|
|
|
|
if (this._body == null) {
|
|
return '';
|
|
}
|
|
|
|
if (typeof this._body === 'object') {
|
|
return JSON.stringify(this._body, null, 2);
|
|
}
|
|
|
|
return this._body.toString();
|
|
}
|
|
|
|
/**
|
|
* Return the body as an ArrayBuffer
|
|
*/
|
|
arrayBuffer(): ArrayBuffer {
|
|
if (this._body instanceof ArrayBuffer) {
|
|
return this._body;
|
|
}
|
|
|
|
return stringToArrayBuffer(this.text());
|
|
}
|
|
|
|
/**
|
|
* Returns the request's body as a Blob, assuming that body exists.
|
|
*/
|
|
blob(): Blob {
|
|
if (this._body instanceof Blob) {
|
|
return this._body;
|
|
}
|
|
|
|
if (this._body instanceof ArrayBuffer) {
|
|
return new Blob([this._body]);
|
|
}
|
|
|
|
throw new Error('The request body isn\'t either a blob or an array buffer');
|
|
}
|
|
}
|