Blob: text() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("File API")}}{{AvailableInWorkers}}

The **text()** method of the {{domxref("Blob")}} interface returns a {{jsxref("Promise")}} that resolves with a string containing the contents of the blob, interpreted as UTF-8.

Syntax

js-nolint
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 {{domxref("FileReader")}} method {{domxref("FileReader.readAsText", "readAsText()")}} is an older method that performs a similar function. It works on both Blob and {{domxref("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

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("Response.text()")}}
  • Streams API
  • {{domxref("FileReader.readAsText()")}}