feat(adapters): add `fetch` adapter #5146

This changeset adds a `fetch`-based adapter implementation to `axios`, powered by `cross-fetch`[1]. The implementation may thus be used on either Node or in browser environments. Changes enclosed: - Add `fetch` adapter implementation - Add `fetch` to standard built-in adapters - Add initial Node-side tests for `fetch` - Slight refactor to tests to use common setup / teardown code Still pending: - Upload/download progress events - Browser-side testing Fixes and closes axios#1219, and supersedes axios#2891.

- Add support for `axios(URL(...))` and `axios({url: URL(...)})` - Add config support for `fetcher`, `fetchOptions` and `parsedUrl` - Translate `config.url = URL(...)` to string - Implement override for `config.fetcher`

- Mock fetch implementation for testing - Spawn fetch adapter configs for testing - Test for expected instance/static props related to fetch adapter

- Add initial browser tests for fetch adapter - Test for acceptance of `URL`

- Add pure JS Node polyfill deps - Add new `generic` dist target for Workers, Deno, etc. - Move to typealiases in `lib/platform/...` rather than direct use - Adapt tests for new alias imports - Drop `cross-fetch`, any need for Node polyfills in pure JS envs

- Implement abstract testsuite structure for fetch - Move browser fetch tests to new implementation + API - Implement pure-JS test for Deno, based on new API - Add test command for Deno (`npm run test:deno`) - Add alias test command for Node (`npm run test:node`) - Add alias to run all tests (`npm run test:all`)

- Add basic fetch overhead benchmark - Add example using new `generic` output

- Define `knownAdapters` for each platform type - Import `knownAdapters` for library defaults - Alias XHR adapter to `#xhrAdapter`, only include in browser libs - Add `.generic.d.*ts` type entries which omit XHR adapter

Temporary: will probably drop before merge

- Setup baseline default and platform-specific `fetchOption`s - Avoids issue with some environments not supporting `cache` - Allows shipping bundles with reasonable defaults for each env

- Support for blob responses (when not identifiable as text) - Small logging enhancements for fetch debug logs - Internal assertions which can be disabled and dropped from `min` bundles, and which ensure correct internal fetch state

- Break response handler selection into dedicated function - Only check for body if response code carries one by spec

- Don't duck-type response based on `response.type`, which is not implemented in CloudFlare Workers' runtime

- Sample which implements the CORS endpoint for testing Axios/Fetch - Serves the Axios Fetch-branch library, but with CORS - Enables testing of ESM

- Add `web-test-runner` and associated dependencies - Add invocation point for pure ESM tests

- Tweak treeshaking to be more aggressive on modern platforms - Move license comment to bottom of output targets

- Structured type for `FetchOptions` - Better type export for `Fetcher` - Better type export for `AxiosFetchAdapter`

- Add support for `beforeEach`/`afterEach` - Add full typings for abstract test types - Prep to extend abstract test suite to Node

- Skip checking config for handler type if no `responseType` param is present - Only resolve handler from `Content-Type` if header is available in response

- Move properties around to avoid stray changes in diffs - Move `cross-fetch` to optional deps

- Instead of failing, bypass URL parsing, and pass the URL verbatim to the underlying fetch implementation

- Move abstract fetch testsuite tests into basic test spec file

Signed-off-by: Sam Gammon <sam@elide.ventures>

Relates to axios#5146 Signed-off-by: Sam Gammon <sam@elide.ventures>

Signed-off-by: Sam Gammon <sam@elide.ventures>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(adapters): add `fetch` adapter #5146

feat(adapters): add `fetch` adapter #5146

Commits on Apr 11, 2024

feat(adapters): add fetch adapter #5146

feat(adapters): add fetch adapter #5146

Commits on Apr 11, 2024

feat(adapters): add `fetch` adapter #5146

feat(adapters): add `fetch` adapter #5146