Blob.text()

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

Syntax

var textPromise = blob.text();

blob.text().then(text => /* do something with the text */);

var text = await blob.text();

Parameters

None.

Returns

A promise that resolves with a USVString 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