Spec-Zone.ru › Web APIs

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

См. также

  • API файлов и записей каталогов
  • Введение в API файлов и записей каталогов

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API