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
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, whereasFileReader.readAsText()
is an event based API.Blob.text()
always uses UTF-8 as encoding, whileFileReader.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
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
text() |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Has more compatibility info.