W3cubDocs

/Web APIs

Blob: text() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨April 2021⁩.

Note: This feature is available in Web Workers.

The text() method of the Blob interface returns a Promise that resolves with a string containing the contents of the blob, interpreted as UTF-8.

Syntax

text()

Parameters

None.

Return value

A promise that resolves with a string which contains the blob's data as a text string. The data is always presumed to be in UTF-8 format.

Usage notes

The FileReader method readAsText() is an older method that performs a similar function. It works on both Blob and File objects. There are two key differences:

  • Blob.text() returns a promise, whereas FileReader.readAsText() is an event based API.
  • Blob.text() always uses UTF-8 as encoding, while FileReader.readAsText() can use a different encoding depending on the blob's type and a specified encoding name.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
text 76 79 69 63 14 76 79 54 14.5 12.0 76 14.5

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Blob/text