fetch-har 9.0.0 → 10.0.0

package/src/index.ts

@@ -6,34 +6,21 @@ import { Readable } from 'readable-stream';
 
 if (!globalThis.Blob) {
   try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-extraneous-dependencies
-    globalThis.Blob = require('formdata-node').Blob;
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    globalThis.Blob = require('node:buffer').Blob;
   } catch (e) {
-    throw new Error(
-      'Since you do not have the Blob API available in this environment you must install the optional `formdata-node` dependency.'
-    );
+    throw new Error('The Blob API is required for this library. https://developer.mozilla.org/en-US/docs/Web/API/Blob');
   }
 }
 
 if (!globalThis.File) {
   try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-extraneous-dependencies
-    globalThis.File = require('formdata-node').File;
+    // Node's native `fetch` implementation unfortunately does not make this API global so we need
+    // to pull it in if we don't have it.
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    globalThis.File = require('undici').File;
   } catch (e) {
-    throw new Error(
-      'Since you do not have the File API available in this environment you must install the optional `formdata-node` dependency.'
-    );
-  }
-}
-
-if (!globalThis.FormData) {
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-extraneous-dependencies
-    globalThis.FormData = require('formdata-node').FormData;
-  } catch (e) {
-    throw new Error(
-      'Since you do not have the FormData API available in this environment you must install the optional `formdata-node` dependency.'
-    );
+    throw new Error('The File API is required for this library. https://developer.mozilla.org/en-US/docs/Web/API/File');
   }
 }
 
@@ -51,10 +38,9 @@ interface RequestInitWithDuplex extends RequestInit {
 }
 
 export interface FetchHAROptions {
-  userAgent?: string;
   files?: Record<string, Blob | Buffer>;
-  multipartEncoder?: any; // form-data-encoder
   init?: RequestInitWithDuplex;
+  userAgent?: string;
 }
 
 type DataURL = npmDataURL & {
@@ -85,34 +71,6 @@ function isFile(value: any) {
   return false;
 }
 
-/**
- * @license MIT
- * @see {@link https://github.com/octet-stream/form-data-encoder/blob/master/lib/util/isFunction.ts}
- */
-function isFunction(value: any) {
-  return typeof value === 'function';
-}
-
-/**
- * We're using this library in here instead of loading it from `form-data-encoder` because that
- * uses lookbehind regex in its main encoder that Safari doesn't support so it throws a fatal page
- * exception.
- *
- * @license MIT
- * @see {@link https://github.com/octet-stream/form-data-encoder/blob/master/lib/util/isFormData.ts}
- */
-function isFormData(value: any) {
-  return (
-    value &&
-    isFunction(value.constructor) &&
-    value[Symbol.toStringTag] === 'FormData' &&
-    isFunction(value.append) &&
-    isFunction(value.getAll) &&
-    isFunction(value.entries) &&
-    isFunction(value[Symbol.iterator])
-  );
-}
-
 function getFileFromSuppliedFiles(filename: string, files: FetchHAROptions['files']) {
   if (filename in files) {
     return files[filename];
@@ -180,7 +138,7 @@ export default function fetchHAR(har: Har, opts: FetchHAROptions = {}) {
         'cookie',
         request.cookies
           .map(cookie => `${encodeURIComponent(cookie.name)}=${encodeURIComponent(cookie.value)}`)
-          .join('; ')
+          .join('; '),
       );
     }
   }
@@ -227,33 +185,6 @@ export default function fetchHAR(har: Har, opts: FetchHAROptions = {}) {
           }
 
           const form = new FormData();
-          if (!isFormData(form)) {
-            /**
-             * The `form-data` NPM module returns one of two things: a native `FormData` API or its
-             * own polyfill. Unfortunately this polyfill does not support the full API of the native
-             * FormData object so when you load `form-data` within a browser environment you'll
-             * have two major differences in API:
-             *
-             *  - The `.append()` API in `form-data` requires that the third argument is an object
-             *    containing various, undocumented, options. In the browser, `.append()`'s third
-             *    argument should only be present when the second is a `Blob` or `USVString`, and
-             *    when it is present, it should be a filename string.
-             *  - `form-data` does not expose an `.entries()` API, so the only way to retrieve data
-             *    out of it for construction of boundary-separated payload content is to use its
-             *    `.pipe()` API. Since the browser doesn't have this API, you'll be unable to
-             * retrieve data out of it.
-             *
-             * Now since the native `FormData` API is iterable, and has the `.entries()` iterator,
-             * we can easily detect if we have a native copy of the FormData API. It's for all of
-             * these reasons that we're opting to hard crash here because supporting this
-             * non-compliant API is more trouble than its worth.
-             *
-             * @see {@link https://github.com/form-data/form-data/issues/124}
-             */
-            throw new Error(
-              "We've detected you're using a non-spec compliant FormData library. We recommend polyfilling FormData with https://npm.im/formdata-node"
-            );
-          }
 
           request.postData.params.forEach(param => {
             if ('fileName' in param) {
@@ -268,7 +199,7 @@ export default function fetchHAR(har: Har, opts: FetchHAROptions = {}) {
                       new File([fileContents], param.fileName, {
                         type: param.contentType || null,
                       }),
-                      param.fileName
+                      param.fileName,
                     );
 
                     return;
@@ -278,7 +209,7 @@ export default function fetchHAR(har: Har, opts: FetchHAROptions = {}) {
                   }
 
                   throw new TypeError(
-                    'An unknown object has been supplied into the `files` config for use. We only support instances of the File API and Node Buffer objects.'
+                    'An unknown object has been supplied into the `files` config for use. We only support instances of the File API and Node Buffer objects.',
                   );
                 }
               }
@@ -299,34 +230,14 @@ export default function fetchHAR(har: Har, opts: FetchHAROptions = {}) {
               }
 
               throw new Error(
-                "The supplied HAR has a postData parameter with `fileName`, but neither `value` content within the HAR or any file buffers were supplied with the `files` option. Since this library doesn't have access to the filesystem, it can't fetch that file."
+                "The supplied HAR has a postData parameter with `fileName`, but neither `value` content within the HAR or any file buffers were supplied with the `files` option. Since this library doesn't have access to the filesystem, it can't fetch that file.",
               );
             }
 
             form.append(param.name, param.value);
           });
 
-          /**
-           * If a the `fetch` polyfill that's being used here doesn't have spec-compliant handling
-           * for the `FormData` API (like `node-fetch@2`), then you should pass in a handler (like
-           * the `form-data-encoder` library) to transform its contents into something that can be
-           * used with the `Request` object.
-           *
-           * @see {@link https://www.npmjs.com/package/formdata-node}
-           */
-          if (opts.multipartEncoder) {
-            // eslint-disable-next-line new-cap
-            const encoder = new opts.multipartEncoder(form);
-            Object.keys(encoder.headers).forEach(header => {
-              headers.set(header, encoder.headers[header]);
-            });
-
-            // @ts-expect-error "Property 'from' does not exist on type 'typeof Readable'." but it does!
-            options.body = Readable.from(encoder);
-            shouldSetDuplex = true;
-          } else {
-            options.body = form;
-          }
+          options.body = form;
           break;
 
         default: