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 January 2020.

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

js
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

Specification
File API
# dom-blob-text

Browser compatibility

BCD tables only load in the browser

See also