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

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

See also

© 2005–2021 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