/** * Copyright (c) Microsoft Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import * as api from '../../types/types'; import { HeadersArray } from '../common/types'; import * as channels from '../protocol/channels'; import { assert, headersObjectToArray, isString, objectToArray } from '../utils/utils'; import { ChannelOwner } from './channelOwner'; import * as network from './network'; import { RawHeaders } from './network'; import { Headers } from './types'; export type FetchOptions = { params?: { [key: string]: string; }, method?: string, headers?: Headers, data?: string | Buffer, timeout?: number, failOnStatusCode?: boolean, }; export class FetchRequest extends ChannelOwner implements api.FetchRequest { static from(channel: channels.FetchRequestChannel): FetchRequest { return (channel as any)._object; } constructor(parent: ChannelOwner, type: string, guid: string, initializer: channels.FetchRequestInitializer) { super(parent, type, guid, initializer); } async get( urlOrRequest: string | api.Request, options?: { params?: { [key: string]: string; }; headers?: { [key: string]: string; }; timeout?: number; failOnStatusCode?: boolean; }): Promise { return this.fetch(urlOrRequest, { ...options, method: 'GET', }); } async post( urlOrRequest: string | api.Request, options?: { params?: { [key: string]: string; }; headers?: { [key: string]: string; }; data?: string | Buffer; timeout?: number; failOnStatusCode?: boolean; }): Promise { return this.fetch(urlOrRequest, { ...options, method: 'POST', }); } async fetch(urlOrRequest: string | api.Request, options: FetchOptions = {}): Promise { return this._wrapApiCall(async (channel: channels.FetchRequestChannel) => { const request: network.Request | undefined = (urlOrRequest instanceof network.Request) ? urlOrRequest as network.Request : undefined; assert(request || typeof urlOrRequest === 'string', 'First argument must be either URL string or Request'); const url = request ? request.url() : urlOrRequest as string; const params = objectToArray(options.params); const method = options.method || request?.method(); // Cannot call allHeaders() here as the request may be paused inside route handler. const headersObj = options.headers || request?.headers() ; const headers = headersObj ? headersObjectToArray(headersObj) : undefined; let postDataBuffer = isString(options.data) ? Buffer.from(options.data, 'utf8') : options.data; if (postDataBuffer === undefined) postDataBuffer = request?.postDataBuffer() || undefined; const postData = (postDataBuffer ? postDataBuffer.toString('base64') : undefined); const result = await channel.fetch({ url, params, method, headers, postData, timeout: options.timeout, failOnStatusCode: options.failOnStatusCode, }); if (result.error) throw new Error(`Request failed: ${result.error}`); return new FetchResponse(this, result.response!); }); } } export class FetchResponse implements api.FetchResponse { private readonly _initializer: channels.FetchResponse; private readonly _headers: RawHeaders; private readonly _request: FetchRequest; constructor(context: FetchRequest, initializer: channels.FetchResponse) { this._request = context; this._initializer = initializer; this._headers = new RawHeaders(this._initializer.headers); } ok(): boolean { return this._initializer.status === 0 || (this._initializer.status >= 200 && this._initializer.status <= 299); } url(): string { return this._initializer.url; } status(): number { return this._initializer.status; } statusText(): string { return this._initializer.statusText; } headers(): Headers { return this._headers.headers(); } headersArray(): HeadersArray { return this._headers.headersArray(); } async body(): Promise { return this._request._wrapApiCall(async (channel: channels.FetchRequestChannel) => { const result = await channel.fetchResponseBody({ fetchUid: this._fetchUid() }); if (!result.binary) throw new Error('Response has been disposed'); return Buffer.from(result.binary!, 'base64'); }); } async text(): Promise { const content = await this.body(); return content.toString('utf8'); } async json(): Promise { const content = await this.text(); return JSON.parse(content); } async dispose(): Promise { return this._request._wrapApiCall(async (channel: channels.FetchRequestChannel) => { await channel.disposeFetchResponse({ fetchUid: this._fetchUid() }); }); } _fetchUid(): string { return this._initializer.fetchUid; } }