FileSystemFileEntry: метод createWriter()
Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или сохранена только для совместимости. По возможности избегайте её использования и обновите существующий код; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Помните, что эта функция может перестать работать в любое время.
Нестандартно: Эта функция нестандартна и не включена в стандарты. Не используйте её на сайтах, ориентированных на веб, в рабочей среде: она не будет работать для каждого пользователя. Также могут существовать значительные несовместимости между реализациями, и поведение может измениться в будущем.
Метод интерфейса FileSystemFileEntry createWriter() возвращает объект FileWriter, который можно использовать для записи данных в файл, представленный записью каталога.
Синтаксис
createWriter(successCallback) createWriter(successCallback, errorCallback)
Параметры
successCallback-
Функция обратного вызова, которая вызывается, когда
FileWriterуспешно создан;FileWriterпередаётся в функцию обратного вызова в качестве единственного параметра. errorCallbackНеобязательно-
Если указано, это метод, который вызывается, когда при попытке создать
FileWriterпроизошла ошибка. Этот обратный вызов получает в качестве входных данных объектFileError, описывающий ошибку.
Возвращаемое значение
Ничего (undefined).
Примеры
В этом примере создаётся метод writeToFileEntry(), который выводит строку текста в файл, соответствующий переданной записи каталога.
function writeToFileEntry(entry, text) {
entry.createWriter(
(fileWriter) => {
let data = Blob([text], { type: "text/plain" });
fileWriter.write(data);
},
(fileError) => {
/* do whatever to handle the error */
},
);
}
Обратный вызов успеха для вызова createWriter() принимает текст, передаваемый в него, и создаёт новый объект Blob типа text/plain, который содержит переданный текст. Затем этот объект blob передаётся в объект FileWriter для записи в файл.
Спецификации
Эта функция больше не является частью спецификаций. Она больше не включена в стандарт.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
createWriter |
8 | 79 | 50–52Хотя методcreateWriter() существовал, он сразу вызывал errorCallback с ошибкой NS_ERROR_DOM_SECURITY_ERR. |
15 | Нет | 18 | 50–52Хотя методcreateWriter() существовал, он сразу вызывал errorCallback с ошибкой NS_ERROR_DOM_SECURITY_ERR. |
14 | Нет | 1.0 | ≤37 |
См. также
© 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/FileSystemFileEntry/createWriter