What's Changed

• Fix - File fetching broken since commit 0c1d2b9 by @mercpls in #1375

New Contributors

• @mercpls made their first contribution in #1375

Full Changelog: v3.6.17...v3.6.18

What's Changed

• Revert "Resolves #928" by @JakeChampion in #1366

Full Changelog: v3.6.16...v3.6.17

What's Changed

• Resolves #928 by @JakeChampion in #1364

Full Changelog: v3.6.15...v3.6.16

What's Changed

• fix #997 by @JakeChampion in #1363

Full Changelog: v3.6.14...v3.6.15

What's Changed

• Fix #1076 by @JakeChampion in #1362

Full Changelog: v3.6.13...v3.6.14

What's Changed

• respect charset within readBlobAsText by @JakeChampion in #1361

Full Changelog: v3.6.12...v3.6.13

What's Changed

• fix: Headers only accepts array which have nested array of length 2 by @JakeChampion in #1360

Full Changelog: v3.6.11...v3.6.12

What's Changed

• Define Body.arrayBuffer even if support.blob is false by @JakeChampion in #1359

Full Changelog: v3.6.10...v3.6.11

What's Changed

• use global Headers if they exist by @JakeChampion in https://github.com/JakeChampion/fetch/pull/1358

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.9...v3.6.10

What's Changed

• fix: when no body supplied, do not set bodyUsed to true by @JakeChampion in https://github.com/JakeChampion/fetch/pull/1357

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.8...v3.6.9

What's Changed

• validate status is in range by @JakeChampion in https://github.com/JakeChampion/fetch/pull/1356

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.7...v3.6.8

18 July 2023

• dont shadow global #1026
• dont use github eslint 408d3b6
• remove invalid-headers test e3f6590
• Update lock.yml permissions e97321b

What's Changed

• fix: ignore not throw on invalid response headers by @pke in https://github.com/JakeChampion/fetch/pull/950

New Contributors

• @pke made their first contribution in https://github.com/JakeChampion/fetch/pull/950

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.5...v3.6.6

What's Changed

• Update caniuse link to use HTTPS and new pattern by @Schweinepriester in https://github.com/JakeChampion/fetch/pull/1087
• Add some missed methods which should be normalized as uppercase by @aleen42 in https://github.com/JakeChampion/fetch/pull/1119

New Contributors

• @Schweinepriester made their first contribution in https://github.com/JakeChampion/fetch/pull/1087
• @aleen42 made their first contribution in https://github.com/JakeChampion/fetch/pull/1119

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.4...v3.6.5

What's Changed

• always set a signal on Request by @romainmenke in https://github.com/JakeChampion/fetch/pull/1003

New Contributors

• @romainmenke made their first contribution in https://github.com/JakeChampion/fetch/pull/1003

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.3...v3.6.4

What's Changed

• Compatible global equals to the false by @cn-coderl in https://github.com/JakeChampion/fetch/pull/967

New Contributors

• @cn-coderl made their first contribution in https://github.com/JakeChampion/fetch/pull/967

Full Changelog: https://github.com/JakeChampion/fetch/compare/v3.6.2...v3.6.3

27 February 2021

• Revert "Represent non-stringified JSON request body as an [object Object] string" e42f201

Bug fixes:

• Fixes a bug in v3.6.0 where the syntax used was not ES3 as it has used const
• Fixes a bug in v3.6.0 where String.prototype.includes was used, which is not supported in IE 11

Both were fixed in https://github.com/github/fetch/pull/914

Bug fixes:

• Improve error message if a header contains an invalid character -- https://github.com/github/fetch/pull/880 Thank you for the contribution @CarmeloPatti

• Make Response.statusText be an empty string if set to undefined and be 'null' if set to null -- https://github.com/github/fetch/pull/897 Thank you for the contribution @tkrotoff

• Represent non-stringified JSON request body as an [object Object] string -- https://github.com/github/fetch/pull/881 Thank you for the contribution @kettanaito

Added a work-around for projects which use core-js -- https://github.com/github/fetch/issues/748

Republishing to ensure the dist/fetch.umd.js is up-to-date

Use globalThis as the global object if it exists #822

4 August 2020

• rename variable to no longer shadow over function of same name c5db762
• remove semicolon to pass linting f264aa5

Features:

• Updated documentation for AbortController to recommend a polyfill which is spec-compliant and fully synchronous. -- https://github.com/github/fetch/pull/814

Bug fixes:

• Fixed the "self is not defined" error that was reported for NodeJS applications - https://github.com/github/fetch/pull/794

• Reverted the DOMException handling refactor as the original code fixed issues in old Android browsers - https://github.com/github/fetch/pull/797

• Response.arrayBuffer() now always resolve with a ArrayBuffer as per the specification. -- https://github.com/github/fetch/pull/816

• Request and Response can now only be called via new (as constructors) as per the specification. -- https://github.com/github/fetch/pull/796

• Headers which are passed as a Headers object no longer have their names normalised as per the specification -- https://github.com/github/fetch/pull/798

Refactor:

• Removed the top-level this to stop warnings being emitted from Rollup. -- https://github.com/github/fetch/pull/815

Features:

• Add support for no-cache and no-store - https://github.com/github/fetch/pull/795

Bug fixes:

• Fixed the "self is not defined" error that was reported for NodeJS applications - https://github.com/github/fetch/pull/794
• Throw a TypeError if Request or Response functions are called without new - https://github.com/github/fetch/pull/796

Refactor:

• Refactor DOMException handling code to avoid redundant exceptions generation - https://github.com/github/fetch/pull/797

Bug fix

-- check if Content-Type header exists prior to examining the value #792

Documentation:

• Added documentation on features of fetch which are not polyfilled. -- https://github.com/github/fetch/pull/734

Bug fixes:

• Empty header names used to not throw an error which was not compliant with the specification. They now throw a TypeError, the same as Chrome, Firefox and Safari do. -- https://github.com/github/fetch/pull/684

• Changed the default status text of a response to align with the specification, the default is now an empty string. -- https://github.com/github/fetch/pull/698

• We now allow exclamation mark as valid header character to align with the specification -- https://github.com/github/fetch/pull/745

• We no longer convert application/octet-stream responses into Blobs if the browser supports ArrayBuffers -- https://github.com/github/fetch/pull/752

• Added compatibility for fetch-mock -- https://github.com/github/fetch/pull/736

• Making a fetch request with an empty string for the url no longer throws a DOMException error in Internet Explorer -- https://github.com/github/fetch/pull/619

• Fixed another Internet Explorer bug to make sure all resolved fetch promises will trigger their promise chains -- https://github.com/github/fetch/pull/575

8 July 2020

• check if Content-Type header exists prior to examining the value #792
• Move from Travis to GitHub Actions #793
• Co-authored-by: Jake Champion <me@jakechampion.name> #575
• work around IE XHR bug with '' URL Fixes #618 #619
• Allow exclamation mark as valid header character #745
• Avoid blob conversion for specific requests #752
• Compatibility for fetch-mock using proxy-pollyfill #736
• Change default statusText for Response #698
• Document more common pitfalls in the README #734
• field name can not by empty #684
• work around IE XHR bug with '' URL Fixes #618 (#619) #618
• Clarify what parts of the standard we don't want to implement #661
• Document more caveats 9a0bce2
• Fix issue #533 7f030fa
• Compatibility with newer eslint-plugin-github 1821b74

v3.0.0

7 September 2018

• Add flow definitions #654
• Match spec behavior re: unsupported body type #651
• Update Karma and detect available browsers when testing #652
• Adopt Contributor Covenant Code of Conduct #649
• Change credentials default value to same-origin #640
• Switch test suite from PhantomJS to Karma #626
• Support abort API #592
• build/distribute as UMD #616
• Test signal reuse. Add AbortSignal polyfill. #2
• Clear abort event listener for all xhr completion states. #1
• Expand install & importing documentation #569
• Match spec behavior re: unsupported body type #576
• Run test files through prettier 0a57487
• Unwrap fetch.js to be a clean module file 8aec47c
• Switch from PhantomJS to Karma + Chrome/Firefox for testing b539589

• The whatwg-fetch package is now a module with exports. The following methods/classes are available:

  • fetch
  • Headers
  • Request
  • Response
  • DOMException

  All exports except for DOMException represent the polyfill implementations, not the native variants if they are available.

  This library still automatically acts like a polyfill if native window.fetch is unavailable; there is currently no way to use it as a ponyfill.

• Change credentials default value omit → same-origin to match the updated spec.

• fetch() and new Request() now accept the signal parameter to accept an AbortSignal.

• Join multiple header values with ,<space> instead of , to match other browsers.

• Convert any Request/Response unsupported body type to a string to match the spec.

• Flow type definitions are now included in the package.

• Support obs-fold as delimiter when parsing raw headers

• Ensure cookies aren't sent if credentials: omit

• Allow status: undefined in Response

• Accept Array argument in Headers constructor

• Treat any non-Request arg to new Request() as string url
• Support Tolerance Provision when parsing HTTP headers

Android 4.0 compatibility:

• Fix reading ArrayBuffer into string on older browsers
• Only define arrayBuffer() if Blob is also supported

This changes the behavior of Headers regarding handling of headers with multiple values. Most notably, it removes the Headers.getAll() method. This diverges from the native implementations of Chrome and Firefox, since those vendors implement an earlier, now outdated version of the spec. The polyfill now acts more similar to Microsoft Edge implementation.

Consider this Headers object:

var h = new Headers()
h.append('accept', 'text/html')
h.append('accept', 'text/plain')
h.append('content-type', 'application/json')

Before:

• h.get('accept') returned text/html
• h.getAll('accept') returned an array of values
• h.forEach (and other iterables) did distinct iterations for each value of the same header

Now:

• h.get('accept') returns text/html,text/plain
• h.getAll() is no more
• h.forEach() (and other iterables) now only do one iteration for each unique header name, regardless of whether it had multiple values

This is in accordance with Section 3.1.2 of the spec, "combine" concept.

Android 4.0 compatibility:

• Fix reading ArrayBuffer into string on older browsers
• Only define arrayBuffer() if Blob is also supported

Spec compatibility:

• 1st argument to Request constructor must be string or Request
• Always construct a new Request instance in fetch()
• Always construct a new Headers instance in Response
• Avoid consuming body when cloning
• Add support for TypedArray/DataView as POST body
• ArrayBuffer, TypedArray, and Dataview bodies can now be accessed through any of the arrayBuffer(), text(), or blob() methods
• Default Response status is 200 OK

Other fixes:

• Make X-Request-URL header case-insensitive
• Allow reusing the same GET Request instance multiple times
• Rework parsing of raw response HTTP headers
• Attach FileReader event handlers before calling its read* method

• Reject promise on request timeout
• Add support for URLSearchParams request body
• Add Headers iterable methods: keys, values, and entries
• No longer compatible with IE9: IE10+ required

• Reject promise on request timeout
• Guard against xhr.getAllResponseHeaders() being null

• Make fetch add a Content-Type header based on the type of the body
• Handle cases where self isn't defined

• Allow making a POST request with an ArrayBuffer body

• Fix handling non-String Headers names and values
• Request object can now be initialized with another Request as 1st parameter
• Allow fetch(request, options) invocation style with existing Request object
• Add request.clone() method
• Add response.clone() method
• Add Response.error() method
• Add Response.redirect(url, status) method

• Invoke forEach callback with value, key, and Headers object.
• Accept a thisArg forEach parameter.

• Fix "Error: INVALID_STATE_ERR: DOM Exception 11".
• Follow spec on credentials 'include' value. Only support standard options.

4 May 2015

• Fetch 0.8.1 09c316d
• Ignore script/ dir 2e39db1

• Add a convenience ok getter on Response
• Follow spec on Headers to throw TypeError
• Headers constructor in Response constructor
• Support Request being passed to fetch()

• Fix up body consuming on request
• Handle FormData in lack of blob case
• Throw TypeError if body is given for GET or HEAD
• Declare deliberate "async=true" on XMLHttpRequest open
• If CORS, with credentials

• Check for xhr.response only when supported.
• Feature test responseType support
• Fix X-Request-URL on CORS requests

• Use xhr.responseType = 'blob' to preserve binary data.
• Add support for arrayBuffer
• Support blob and string BodyInit

• Expose Headers, Request and Response to window
• Conditionally define Response#blob
• Default credentials to 'omit'
• Add X-Request-URL support
• Make Headers case insensitive though lowercasing. This implementation is not case preserving when iterating over a Headers object.