FileReaderSync: метод readAsText()

Базовая поддержка Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

Примечание: Эта функция доступна только в потоках Web Workers, за исключением Service Workers.

Метод readAsText() интерфейса FileReaderSync позволяет синхронно прочитать объекты File или Blob в строку. Этот интерфейс доступен только в рабочих потоках, так как он позволяет производить синхронный ввод-вывод, который потенциально может заблокировать поток.

Синтаксис

readAsText(blob)
readAsText(blob, encoding)

Параметры

blob: Объект File или Blob для чтения.
encoding Необязательно: Необязательный параметр, определяющий кодировку (например, iso-8859-1 или UTF-8). Если он отсутствует, метод будет использовать алгоритм определения кодировки.

Возвращаемое значение

Строка, представляющая входные данные.

Исключения

Данный метод может вызывать следующие исключения:

NotFoundError DOMException

Выбрасывается, если ресурс, представленный объектом DOM File или Blob, не найден, например, потому что он был удалён.

SecurityError DOMException

Выбрасывается, если обнаружена одна из следующих проблемных ситуаций:

ресурс был изменён третьей стороной;
одновременно выполняется слишком много операций чтения;
файл, на который ссылается ресурс, небезопасен для использования в веб-приложении (например, это системный файл).

NotReadableError DOMException

Выбрасывается, если ресурс не может быть прочитан из-за проблемы с правами доступа, например, из-за блокировки.

EncodingError DOMException

Выбрасывается, если ресурс представляет собой URL данных и превышает предел длины, определённый каждым браузером.

Спецификации

Спецификация
File API # readAsTextSync

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`readAsText`	7	12	8	≤12.1	6	18	8	≤12.1	6	1.0	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileReaderSync/readAsText