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.
Please take two minutes to fill out our short survey.
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, 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 |