feat!: fetch (POC)

README.md

@@ -4,7 +4,7 @@
 [![codecov](https://codecov.io/gh/googleapis/gaxios/branch/master/graph/badge.svg)](https://codecov.io/gh/googleapis/gaxios)
 [![Code Style: Google](https://img.shields.io/badge/code%20style-google-blueviolet.svg)](https://github.com/google/gts)
 
-> An HTTP request client that provides an `axios` like interface over top of `node-fetch`.
+> An HTTP request client that provides a lightweight interface on top of `fetch`.
 
 ## Install
 
@@ -16,9 +16,7 @@ $ npm install gaxios
 
 ```js
 const {request} = require('gaxios');
-const res = await request({
-  url: 'https://www.googleapis.com/discovery/v1/apis/',
-});
+const res = await request('https://www.googleapis.com/discovery/v1/apis/');
 ```
 
 ## Setting Defaults
@@ -41,6 +39,9 @@ over other authentication methods, i.e., application default credentials.
 
 ## Request Options
 
+`GaxiosOptions` extends from [`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit).
+`Gaxios#request` also accepts [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request) objects as well.
+
 ```ts
 interface GaxiosOptions = {
   // The url to which the request should be sent.  Required.
@@ -53,16 +54,26 @@ interface GaxiosOptions = {
   baseURL: 'https://example.com';
 
   // The HTTP methods to be sent with the request.
-  headers: { 'some': 'header' },
-
-  // The data to send in the body of the request. Data objects will be
-  // serialized as JSON.
+  headers: { 'some': 'header' } || new Headers(),
+
+  // The data to send in the body of the request. Objects will be serialized as JSON
+  // except for:
+  // - `ArrayBuffer`
+  // - `Blob`
+  // - `Buffer` (Node.js)
+  // - `DataView`
+  // - `File`
+  // - `FormData`
+  // - `ReadableStream`
+  // - `stream.Readable` (Node.js)
+  // - strings
+  // - `TypedArray` (e.g. `Uint8Array`, `BigInt64Array`)
+  // - `URLSearchParams`
+  // - all other objects where:
+  //   - headers['Content-Type'] === 'application/x-www-form-urlencoded' (serialized as `URLSearchParams`)
   //
-  // Note: if you would like to provide a Content-Type header other than
-  // application/json you you must provide a string or readable stream, rather
-  // than an object:
-  // data: JSON.stringify({some: 'data'})
-  // data: fs.readFile('./some-data.jpeg')
+  // In all other cases, if you would like to prevent `application/json` as the
+  // default you must set the `Content-Type` header.
   data: {
     some: 'data'
   },
@@ -71,23 +82,12 @@ interface GaxiosOptions = {
   // Defaults to `0`, which is the same as unset.
   maxContentLength: 2000,
 
-  // The max number of HTTP redirects to follow.
-  // Defaults to 100.
-  maxRedirects: 100,
-
-  // The querystring parameters that will be encoded using `qs` and
+  // The query parameters that will be encoded using `URLSearchParams` and
   // appended to the url
   params: {
     querystring: 'parameters'
   },
 
-  // By default, we use the `querystring` package in node core to serialize
-  // querystring parameters.  You can override that and provide your
-  // own implementation.
-  paramsSerializer: (params) => {
-    return qs.stringify(params);
-  },
-
   // The timeout for the HTTP request in milliseconds. Defaults to 0.
   timeout: 1000,
 
@@ -105,6 +105,8 @@ interface GaxiosOptions = {
   // The expected return type of the request.  Options are:
   // json | stream | blob | arraybuffer | text | unknown
   // Defaults to `unknown`.
+  // If the `fetchImplementation` is native `fetch`, the
+  // stream is a `ReadableStream`, otherwise `readable.Stream`
   responseType: 'unknown',
 
   // The node.js http agent to use for the request.
@@ -114,9 +116,9 @@ interface GaxiosOptions = {
   // status code.  Defaults to (>= 200 && < 300)
   validateStatus: (status: number) => true,
 
-  // Implementation of `fetch` to use when making the API call. By default,
-  // will use the browser context if available, and fall back to `node-fetch`
-  // in node.js otherwise.
+  /**
+   * Implementation of `fetch` to use when making the API call. Will use `fetch` by default.
+   */
   fetchImplementation?: typeof fetch;
 
   // Configuration for retrying of requests.
@@ -151,8 +153,7 @@ interface GaxiosOptions = {
   // Enables default configuration for retries.
   retry: boolean,
 
-  // Cancelling a request requires the `abort-controller` library.
-  // See https://github.com/bitinn/node-fetch#request-cancellation-with-abortsignal
+  // Enables aborting via AbortController
   signal?: AbortSignal
 
   /**

browser-test/test.browser.ts

@@ -14,7 +14,6 @@
 import assert from 'assert';
 import {describe, it} from 'mocha';
 import {request} from '../src/index';
-import * as uuid from 'uuid';
 const port = 7172; // should match the port defined in `webserver.ts`
 
 describe('💻 browser tests', () => {
@@ -53,7 +52,8 @@ describe('💻 browser tests', () => {
         body: 'hello world!',
       },
     ];
-    const boundary = uuid.v4();
+    const boundary =
+      globalThis?.crypto.randomUUID() || (await import('crypto')).randomUUID();
     const finale = `--${boundary}--`;
     headers['Content-Type'] = `multipart/related; boundary=${boundary}`;
 

package.json

@@ -47,18 +47,14 @@
     "@types/mv": "^2.1.0",
     "@types/ncp": "^2.0.1",
     "@types/node": "^20.0.0",
-    "@types/node-fetch": "^2.5.7",
     "@types/sinon": "^17.0.0",
     "@types/tmp": "0.2.6",
-    "@types/uuid": "^10.0.0",
-    "abort-controller": "^3.0.0",
     "assert": "^2.0.0",
     "browserify": "^17.0.0",
     "c8": "^8.0.0",
     "cors": "^2.8.5",
     "execa": "^5.0.0",
     "express": "^4.16.4",
-    "form-data": "^4.0.0",
     "gts": "^5.0.0",
     "is-docker": "^2.0.0",
     "karma": "^6.0.0",
@@ -74,7 +70,7 @@
     "multiparty": "^4.2.1",
     "mv": "^2.1.1",
     "ncp": "^2.0.0",
-    "nock": "^13.0.0",
+    "nock": "^14.0.0-beta.13",
     "null-loader": "^4.0.0",
     "puppeteer": "^19.0.0",
     "sinon": "^18.0.0",
@@ -87,9 +83,6 @@
   },
   "dependencies": {
     "extend": "^3.0.2",
-    "https-proxy-agent": "^7.0.1",
-    "is-stream": "^2.0.0",
-    "node-fetch": "^2.6.9",
-    "uuid": "^10.0.0"
+    "https-proxy-agent": "^7.0.1"
   }
 }