Расширения Manifest V2 были удалены из Chrome Web Store 31 августа 2026 года. Перенесите свое расширение на Manifest V3, чтобы оно снова стало доступно пользователям.

Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Описание

Используйте API chrome.fileSystemProvider, чтобы создавать файловые системы, доступные из файлового менеджера в Chrome OS.

Разрешения

fileSystemProvider

Доступность

Только для ChromeOS

Манифест

Чтобы использовать File System Provider API, необходимо объявить разрешение fileSystemProvider и раздел в манифесте расширения. Пример:

{
  "name": "My extension",
  ...
  "permissions": [
    "fileSystemProvider"
  ],
  ...
  "file_system_provider_capabilities": {
    "configurable": true,
    "watchable": false,
    "multiple_mounts": true,
    "source": "network"
  },
  ...
}

Раздел file_system_provider должен быть объявлен следующим образом:

configurable (логическое значение) – необязательно.: Поддерживается ли настройка через onConfigureRequested. Значение по умолчанию – false.
multiple_mounts (логическое значение) – необязательно.: Поддерживается ли несколько (более одной) подключенных файловых систем. Значение по умолчанию – false.
watchable (логическое значение) – необязательно.: Поддерживается ли настройка наблюдателей и уведомление об изменениях. Значение по умолчанию – false.
source (перечисление file, device или network) – обязательный параметр.: Источник данных для подключенных файловых систем.

Приложение Files использует эту информацию, чтобы правильно отображать элементы интерфейса. Например, если для параметра configurable задано значение True, будет показан пункт меню для настройки томов. Аналогично, если для правила multiple_mounts задано значение true, в приложении "Файлы" можно будет добавить несколько точек подключения. Если для параметра watchable задано значение false, будет показана кнопка обновления. По возможности добавьте поддержку наблюдателей, чтобы изменения в файловой системе отражались немедленно и автоматически.

Обзор

File System Provider API позволяет расширениям поддерживать виртуальные файловые системы, доступные в файловом менеджере в ChromeOS. Например, это может быть распаковка архивов и доступ к файлам в облачном сервисе, отличном от Диска.

Монтирование файловых систем

Расширения могут предоставлять контент файловой системы из внешнего источника (например, удаленного сервера или USB-устройства) или использовать в качестве входных данных локальный файл (например, архив).

Чтобы создать файловую систему, которая является обработчиком файлов (источник – "file"), поставщик должен быть упакованным приложением, так как событие onLaunched недоступно для расширений.

Если источником является сеть или устройство, файловая система должна быть подключена при вызове события onMountRequested.

Источник данных файловой системы.	Точка входа
`"file"`	Доступно только для упакованных приложений.
`"device"` или `"network"`	onMountRequested

Настройка файловых систем

После подключения файловые системы можно настроить с помощью события onConfigureRequested. Это особенно полезно для файловых систем, которые предоставляют контент по сети, чтобы задать правильные учетные данные. Обрабатывать это событие необязательно.

Жизненный цикл

После подключения файловые системы сохраняются в Chrome и автоматически подключаются после перезагрузки или перезапуска. Поэтому после того, как файловая система подключена расширением, она будет оставаться подключенной, пока расширение не будет выгружено или пока оно не вызовет метод unmount.

Типы

AbortRequestedOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
operationRequestId

число

Идентификатор запроса, который нужно отменить.
requestId

число

Уникальный идентификатор этого запроса.

Action

Chrome 45 и более поздних версий;

Свойства

id

string

Идентификатор действия. Любая строка или CommonActionId для распространенных действий.
название

Строка (необязательно)

Название действия. Для стандартных действий оно может игнорироваться.

AddWatcherRequestedOptions

Свойства

entryPath

string

Путь к записи, за которой нужно наблюдать.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
рекурсивный

Логическое значение

Должно ли наблюдение включать все дочерние записи рекурсивно. Это значение может быть истинным только для каталогов.
requestId

число

Уникальный идентификатор этого запроса.

Change

Свойства

changeType

ChangeType

Тип изменения, которое произошло с записью.
cloudFileInfo

CloudFileInfo необязательный

Chrome 125 и более поздних версий

Информация о файле, если он хранится в облачной файловой системе.
entryPath

string

Путь к измененной записи.

ChangeType

Тип изменения, обнаруженного в наблюдаемом каталоге.

Перечисление

"CHANGED"

"DELETED"

CloseFileRequestedOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
openRequestId

число

Идентификатор запроса, используемый для открытия файла.
requestId

число

Уникальный идентификатор этого запроса.

CloudFileInfo

Chrome 125 и более поздних версий

Свойства

versionTag

Строка (необязательно)

Тег, представляющий версию файла.

CloudIdentifier

Chrome 117 и более поздних версий

Свойства

id

string

Идентификатор поставщика для указанного файла или каталога.
providerName

string

Идентификатор поставщика облачного хранилища (например, drive.google.com).

CommonActionId

Chrome 45 и более поздних версий;

Список стандартных действий. "SHARE" – это сервис для обмена файлами. "SAVE_FOR_OFFLINE" для закрепления (сохранения для офлайн-режима). "OFFLINE_NOT_NECESSARY" – для уведомления о том, что файл больше не нужно хранить для офлайн-доступа. Используется в onGetActionsRequested и onExecuteActionRequested.

Перечисление

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"SHARE"

ConfigureRequestedOptions

Chrome 44 и более поздних версий;

Свойства

fileSystemId

string

Идентификатор файловой системы, которую нужно настроить.
requestId

число

Уникальный идентификатор этого запроса.

CopyEntryRequestedOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
requestId

число

Уникальный идентификатор этого запроса.
sourcePath

string

Исходный путь к записи, которую нужно скопировать.
targetPath

string

Целевой путь для операции копирования.

CreateDirectoryRequestedOptions

Свойства

directoryPath

string

Путь к создаваемому каталогу.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
рекурсивный

Логическое значение

Указывает, является ли операция рекурсивной (только для каталогов).
requestId

число

Уникальный идентификатор этого запроса.

CreateFileRequestedOptions

Свойства

filePath

string

Путь к создаваемому файлу.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
requestId

число

Уникальный идентификатор этого запроса.

DeleteEntryRequestedOptions

Свойства

entryPath

string

Путь к записи, которую нужно удалить.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
рекурсивный

Логическое значение

Указывает, является ли операция рекурсивной (только для каталогов).
requestId

число

Уникальный идентификатор этого запроса.

EntryMetadata

Свойства

cloudFileInfo

CloudFileInfo необязательный

Chrome 125 и более поздних версий

Информация, которая идентифицирует определенный файл в базовой облачной файловой системе. Обязательно, если запрашивается в options и файл хранится в облачном хранилище.
cloudIdentifier

CloudIdentifier необязательный

Chrome 117 и более поздних версий

Представление этой записи в облачном хранилище. Обязательно, если запрашивается в options и файл хранится в облачном хранилище. Для локальных файлов, не сохраненных в облачном хранилище, при запросе должно быть указано undefined.
isDirectory

Логическое значение (необязательно)

True, если это каталог. Обязательно, если запрашивается в options.
mimeType

Строка (необязательно)

MIME-тип записи. Всегда необязательно, но должно быть предоставлено, если запрашивается в options.
modificationTime

Дата необязательно

Время последнего изменения этой записи. Обязательно, если запрашивается в options.
name

Строка (необязательно)

Название записи (не полный путь). Не должен содержать символ "/". Для корневого каталога должен быть пустым. Обязательно, если запрашивается в options.
размер

number (необязательно)

Размер файла в байтах. Обязательно, если запрашивается в options.
значок

Строка (необязательно)

Изображение значка в виде URI данных в формате PNG, JPEG или WEBP размером не более 32 КБ. Необязательный параметр, который можно указать, только если он явно запрашивается событием onGetMetadataRequested.

ExecuteActionRequestedOptions

Chrome 45 и более поздних версий;

Свойства

actionId

string

Идентификатор действия, которое нужно выполнить.
entryPaths

string[]

Chrome 47 и более поздних версий;

Набор путей к записям, которые будут использоваться для действия.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
requestId

число

Уникальный идентификатор этого запроса.

FileSystemInfo

Свойства

displayName

string

Человекочитаемое название файловой системы.
fileSystemId

string

Идентификатор файловой системы.
openedFiles

OpenedFile[]

Список открытых файлов.
openedFilesLimit

число

Максимальное количество файлов, которые можно открыть одновременно. Если указано значение 0, ограничение не действует.
supportsNotifyTag

Логическое значение (необязательно)

Chrome 45 и более поздних версий;

Поддерживает ли файловая система поле tag для отслеживания каталогов.
зрители

Watcher[]

Chrome 45 и более поздних версий;

Список наблюдателей.
Редактируемый объект

Логическое значение

Поддерживает ли файловая система операции, которые могут изменить ее содержимое (например, создание, удаление или запись файлов).

GetActionsRequestedOptions

Chrome 45 и более поздних версий;

Свойства

entryPaths

string[]

Chrome 47 и более поздних версий;

Список путей к записям для списка действий.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
requestId

число

Уникальный идентификатор этого запроса.

GetMetadataRequestedOptions

Свойства

cloudFileInfo

Логическое значение

Chrome 125 и более поздних версий

Если запрашивается значение cloudFileInfo, задайте значение true.
cloudIdentifier

Логическое значение

Chrome 117 и более поздних версий

Если запрашивается значение cloudIdentifier, задайте значение true.
entryPath

string

Путь к записи, метаданные которой нужно получить.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
isDirectory

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение is_directory, задайте значение true.
mimeType

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение mimeType, задайте значение true.
modificationTime

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение modificationTime, задайте значение true.
name

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение name, задайте значение true.
requestId

число

Уникальный идентификатор этого запроса.
размер

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение size, задайте значение true.
значок

Логическое значение

Если запрашивается значение thumbnail, задайте значение true.

MountOptions

Свойства

displayName

string

Человекочитаемое название файловой системы.
fileSystemId

string

Строковый идентификатор файловой системы. Должен быть уникальным для каждого расширения.
openedFilesLimit

number (необязательно)

Максимальное количество файлов, которые можно открыть одновременно. Если значение не указано или равно 0, ограничение не применяется.
постоянный

Логическое значение (необязательно)

Chrome 64 и более поздних версий;

Должен ли фреймворк возобновить работу файловой системы при следующем входе в систему. По умолчанию используется значение true.
supportsNotifyTag

Логическое значение (необязательно)

Chrome 45 и более поздних версий;

Поддерживает ли файловая система поле tag для отслеживаемых каталогов.
Редактируемый объект

Логическое значение (необязательно)

Поддерживает ли файловая система операции, которые могут изменить ее содержимое (например, создание, удаление или запись файлов).

MoveEntryRequestedOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
requestId

число

Уникальный идентификатор этого запроса.
sourcePath

string

Исходный путь к записи, которую нужно переместить.
targetPath

string

Целевой путь для операции копирования.

NotifyOptions

Свойства

changeType

ChangeType

Тип изменения, которое произошло с наблюдаемой записью. Если запись удалена, она будет автоматически удалена из списка отслеживаемых записей.
Изменения

Change[] необязательный

Список изменений в записях в отслеживаемом каталоге (включая саму запись)
fileSystemId

string

Идентификатор файловой системы, связанной с этим изменением.
observedPath

string

Путь к наблюдаемой записи.
рекурсивный

Логическое значение

Режим наблюдаемой записи.
тег

Строка (необязательно)

Тег уведомления. Требуется, если файловая система была подключена с параметром supportsNotifyTag. Обратите внимание, что этот флаг необходим для отправки уведомлений об изменениях, которые произошли, даже когда система была выключена.

OpenedFile

Свойства

filePath

string

Путь к открытому файлу.
режим

OpenFileMode

Был ли файл открыт для чтения или записи.
openRequestId

число

Идентификатор запроса, который будет использоваться для последующих запросов на чтение, запись и закрытие.

OpenFileMode

Режим открытия файла. Используется onOpenFileRequested.

Перечисление

"READ"

"WRITE"

OpenFileRequestedOptions

Свойства

filePath

string

Путь к файлу, который нужно открыть.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
режим

OpenFileMode

Будет ли файл использоваться для чтения или записи.
requestId

число

Идентификатор запроса, который будет использоваться последующими запросами на чтение, запись и закрытие.

ProviderError

Коды ошибок, используемые расширениями-поставщиками в ответ на запросы, а также в случае ошибок при вызове методов API. Правильный ответ – "OK".

Перечисление

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Свойства

directoryPath

string

Путь к каталогу, содержимое которого запрашивается.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
isDirectory

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение is_directory, задайте значение true.
mimeType

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение mimeType, задайте значение true.
modificationTime

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение modificationTime, задайте значение true.
name

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение name, задайте значение true.
requestId

число

Уникальный идентификатор этого запроса.
размер

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение size, задайте значение true.
значок

Логическое значение

Chrome 49 и более поздних версий;

Если запрашивается значение thumbnail, задайте значение true.

ReadFileRequestedOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
длина

число

Количество байтов, которые нужно вернуть.
вычесть

число

Позиция в файле (в байтах), с которой нужно начать чтение.
openRequestId

число

Идентификатор запроса, используемый для открытия файла.
requestId

число

Уникальный идентификатор этого запроса.

RemoveWatcherRequestedOptions

Свойства

entryPath

string

Путь к отслеживаемой записи.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
рекурсивный

Логическое значение

Режим наблюдателя.
requestId

число

Уникальный идентификатор этого запроса.

TruncateRequestedOptions

Свойства

filePath

string

Путь к файлу, который нужно усечь.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
длина

число

Количество байтов, которые нужно сохранить после завершения операции.
requestId

число

Уникальный идентификатор этого запроса.

UnmountOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, которую нужно отключить.

UnmountRequestedOptions

Свойства

fileSystemId

string

Идентификатор файловой системы, которую нужно отключить.
requestId

число

Уникальный идентификатор этого запроса.

Watcher

Свойства

entryPath

string

Путь к наблюдаемой записи.
lastTag

Строка (необязательно)

Тег, использованный в последнем уведомлении для наблюдателя.
рекурсивный

Логическое значение

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

WriteFileRequestedOptions

Свойства

делал.

ArrayBuffer

Буфер байтов, которые нужно записать в файл.
fileSystemId

string

Идентификатор файловой системы, связанной с этой операцией.
вычесть

число

Позиция в файле (в байтах), с которой нужно начать запись байтов.
openRequestId

число

Идентификатор запроса, используемый для открытия файла.
requestId

число

Уникальный идентификатор этого запроса.

Методы

get()

Promise

chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
): Promise<FileSystemInfo>

Возвращает информацию о файловой системе с переданным fileSystemId.

Параметры

fileSystemId

string
обратный вызов

function необязательно

Параметр callback выглядит следующим образом:
```
(fileSystem: FileSystemInfo) => void
```
- fileSystem
  
  FileSystemInfo

Возвраты

Promise<FileSystemInfo>

Chrome 96 и более поздних версий;

Обратный вызов для получения результата функции get.

Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getAll()

Promise

chrome.fileSystemProvider.getAll(
  callback?: function,
): Promise<FileSystemInfo[]>

Возвращает все файловые системы, подключенные расширением.

Параметры

обратный вызов

function необязательно

Параметр callback выглядит следующим образом:
```
(fileSystems: FileSystemInfo[]) => void
```
- fileSystems
  
  FileSystemInfo[]

Возвраты

Promise<FileSystemInfo[]>

Chrome 96 и более поздних версий;

Обратный вызов для получения результата функции getAll.

Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

mount()

Promise

chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
): Promise<void>

Подключает файловую систему с заданными параметрами fileSystemId и displayName. displayName будет показываться на левой панели приложения "Файлы". displayName может содержать любые символы, включая косую черту, но не может быть пустой строкой. displayName должно быть описательным, но не обязательно уникальным. Строка fileSystemId не должна быть пустой.

В зависимости от типа монтируемой файловой системы необходимо правильно задать параметр source.

В случае ошибки в runtime.lastError будет указан соответствующий код ошибки.

Параметры

Параметры

MountOptions
обратный вызов

function необязательно

Параметр callback выглядит следующим образом:
```
() => void
```

Возвраты

Promise<void>

Chrome 96 и более поздних версий;

Общий обратный вызов результата, указывающий на успех или неудачу.

Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

notify()

Promise Chrome 45+

chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

Уведомляет об изменениях в отслеживаемом каталоге по пути observedPath в режиме recursive. Если файловая система смонтирована с supportsNotifyTag, то необходимо предоставить tag и всегда сообщать обо всех изменениях с момента последнего уведомления, даже если система была выключена. Последний тег можно получить с помощью метода getAll.

Чтобы использовать эту функцию, для параметра манифеста file_system_provider.notify должно быть задано значение true.

Значением tag может быть любая строка, уникальная для каждого вызова, чтобы можно было идентифицировать последнее зарегистрированное уведомление. Например, если расширение запускается после перезагрузки, а тег последнего зарегистрированного уведомления – "123", то для всех изменений, произошедших после изменения с тегом "123", должно вызываться notify. Это поле не может быть пустым.

Не все поставщики могут предоставить тег, но если в файловой системе есть журнал изменений, то тегом может быть, например, номер изменения или номер версии.

Обратите внимание, что при удалении родительского каталога удаляются и все дочерние записи. Если они отслеживаются, API должен быть уведомлен об этом. Кроме того, если каталог переименован, все дочерние записи удаляются, поскольку по исходным путям больше нет записей.

В случае ошибки runtime.lastError будет задан соответствующий код ошибки.

Параметры

Параметры

NotifyOptions
обратный вызов

function необязательно

Параметр callback выглядит следующим образом:
```
() => void
```

Возвраты

Promise<void>

Chrome 96 и более поздних версий;

Общий обратный вызов результата, указывающий на успех или неудачу.

Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

unmount()

Promise

chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
): Promise<void>

Отключает файловую систему с заданным идентификатором fileSystemId. Его необходимо вызывать после onUnmountRequested. Кроме того, расширение может самостоятельно выполнить размонтирование, если это необходимо (например, в случае потери соединения или ошибки файла).

В случае ошибки в runtime.lastError будет указан соответствующий код ошибки.

Параметры

Параметры

UnmountOptions
обратный вызов

function необязательно

Параметр callback выглядит следующим образом:
```
() => void
```

Возвраты

Promise<void>

Chrome 96 и более поздних версий;

Общий обратный вызов результата, указывающий на успех или неудачу.

Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onAbortRequested

chrome.fileSystemProvider.onAbortRequested.addListener(
  callback: function,
)

Возникает, когда запрашивается отмена операции с помощью operationRequestId. Операция, выполняемая с помощью operationRequestId, должна быть немедленно остановлена, а successCallback этого запроса на отмену – выполнена. Если прервать операцию не удается, необходимо вызвать errorCallback. Обратите внимание, что обратные вызовы прерванной операции не должны вызываться, так как они будут игнорироваться. Несмотря на вызов errorCallback, запрос может быть принудительно прерван.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  AbortRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onAddWatcherRequested

Chrome 45 и более поздних версий;

chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Возникает при запросе на установку нового наблюдателя за каталогом. Если возникает ошибка, необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  AddWatcherRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onCloseFileRequested

chrome.fileSystemProvider.onCloseFileRequested.addListener(
  callback: function,
)

Возникает, когда запрашивается закрытие файла, ранее открытого с помощью openRequestId.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  CloseFileRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onConfigureRequested

Chrome 44 и более поздних версий;

chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Возникает, когда запрашивается показ диалогового окна конфигурации для fileSystemId. Если да, то для параметра file_system_provider.configurable в манифесте должно быть задано значение true.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  ConfigureRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onCopyEntryRequested

chrome.fileSystemProvider.onCopyEntryRequested.addListener(
  callback: function,
)

Возникает при запросе на копирование записи (рекурсивно, если это каталог). Если возникает ошибка, необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  CopyEntryRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onCreateDirectoryRequested

chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
  callback: function,
)

Возникает при запросе на создание каталога. Если целевой каталог уже существует, операция должна завершиться ошибкой EXISTS. Если для параметра recursive задано значение True, то все отсутствующие каталоги в пути к каталогу должны быть созданы.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  CreateDirectoryRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onCreateFileRequested

chrome.fileSystemProvider.onCreateFileRequested.addListener(
  callback: function,
)

Возникает при запросе на создание файла. Если файл уже существует, то errorCallback должен вызываться с кодом ошибки "EXISTS".

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  CreateFileRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onDeleteEntryRequested

chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
  callback: function,
)

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

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  DeleteEntryRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onExecuteActionRequested

Chrome 48 и более поздних версий;

chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Возникает при запросе на выполнение действия для набора файлов или каталогов. После завершения действия необходимо вызвать successCallback. В случае ошибки необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: ExecuteActionRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  ExecuteActionRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onGetActionsRequested

Chrome 48 и более поздних версий;

chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Срабатывает, когда запрашивается список действий для набора файлов или каталогов в entryPaths. Все возвращенные действия должны быть применимы к каждой записи. Если таких действий нет, должен возвращаться пустой массив. Действия должны возвращаться с вызовом successCallback. В случае ошибки необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  GetActionsRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
(actions: Action[]) => void
```
  - действия
    
    Action[]
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onGetMetadataRequested

chrome.fileSystemProvider.onGetMetadataRequested.addListener(
  callback: function,
)

Возникает при запросе метаданных файла или каталога по адресу entryPath. Метаданные должны возвращаться с вызовом successCallback. В случае ошибки необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  GetMetadataRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
(metadata: EntryMetadata) => void
```
  - метаданные
    
    EntryMetadata
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onMountRequested

Chrome 44 и более поздних версий;

chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Вызывается, когда запрашивается показ диалогового окна для подключения новой файловой системы. Если расширение или приложение является обработчиком файлов, это событие не должно обрабатываться. Вместо этого для подключения новых файловых систем при открытии файла следует использовать app.runtime.onLaunched. Если точек подключения несколько, для параметра file_system_provider.multiple_mounts в манифесте должно быть задано значение true.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(successCallback: function, errorCallback: function) => void
```
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onMoveEntryRequested

chrome.fileSystemProvider.onMoveEntryRequested.addListener(
  callback: function,
)

Возникает при запросе на перемещение записи (рекурсивно, если это каталог). Если возникает ошибка, необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  MoveEntryRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onOpenFileRequested

chrome.fileSystemProvider.onOpenFileRequested.addListener(
  callback: function,
)

Возникает при запросе на открытие файла по адресу filePath. Если файл не существует, операция должна завершиться ошибкой. Максимальное количество файлов, которые можно открыть одновременно, можно указать с помощью MountOptions.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  OpenFileRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
(metadata?: EntryMetadata) => void
```
  - метаданные
    
    EntryMetadata необязательный
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onReadDirectoryRequested

chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
  callback: function,
)

Возникает при запросе содержимого каталога по адресу directoryPath. Результаты должны возвращаться частями, для чего нужно несколько раз вызвать successCallback. В случае ошибки необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  ReadDirectoryRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
(entries: EntryMetadata[], hasMore: boolean) => void
```
  - записи
    
    EntryMetadata[]
  - hasMore
    
    Логическое значение
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onReadFileRequested

chrome.fileSystemProvider.onReadFileRequested.addListener(
  callback: function,
)

Возникает при запросе на чтение содержимого файла, ранее открытого с помощью openRequestId. Результаты должны возвращаться частями путем многократного вызова successCallback. В случае ошибки необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  ReadFileRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
(data: ArrayBuffer, hasMore: boolean) => void
```
  - делал.
    
    ArrayBuffer
  - hasMore
    
    Логическое значение
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onRemoveWatcherRequested

Chrome 45 и более поздних версий;

chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

Вызывается, когда наблюдатель должен быть удален. Если возникает ошибка, необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  RemoveWatcherRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onTruncateRequested

chrome.fileSystemProvider.onTruncateRequested.addListener(
  callback: function,
)

Возникает, когда запрашивается усечение файла до нужной длины. Если возникает ошибка, необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  TruncateRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onUnmountRequested

chrome.fileSystemProvider.onUnmountRequested.addListener(
  callback: function,
)

Срабатывает, когда запрашивается размонтирование файловой системы с идентификатором fileSystemId. В ответе метод API unmount должен вызываться вместе с successCallback. Если размонтирование невозможно (например, из-за ожидающей операции), необходимо вызвать errorCallback.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  UnmountRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

onWriteFileRequested

chrome.fileSystemProvider.onWriteFileRequested.addListener(
  callback: function,
)

Возникает при запросе на запись контента в файл, ранее открытый с помощью openRequestId.

Параметры

обратный вызов

function

Параметр callback выглядит следующим образом:
```
(options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- Параметры
  
  WriteFileRequestedOptions
- successCallback
  
  function
  
  Параметр successCallback выглядит следующим образом:
```
() => void
```
- errorCallback
  
  function
  
  Параметр errorCallback выглядит следующим образом:
```
(error: ProviderError) => void
```
  - ошибка
    
    ProviderError

chrome.fileSystemProvider Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Описание

Разрешения

Доступность

Манифест

Обзор

Монтирование файловых систем

Настройка файловых систем

Жизненный цикл

Типы

AbortRequestedOptions

Свойства

Action

Свойства

AddWatcherRequestedOptions

Свойства

Change

Свойства

ChangeType

Перечисление

CloseFileRequestedOptions

Свойства

CloudFileInfo

Свойства

CloudIdentifier

Свойства

CommonActionId

Перечисление

ConfigureRequestedOptions

Свойства

CopyEntryRequestedOptions

Свойства

CreateDirectoryRequestedOptions

Свойства

CreateFileRequestedOptions

Свойства

DeleteEntryRequestedOptions

Свойства

EntryMetadata

Свойства

ExecuteActionRequestedOptions

Свойства

FileSystemInfo

Свойства

GetActionsRequestedOptions

Свойства

GetMetadataRequestedOptions

Свойства

MountOptions

Свойства

MoveEntryRequestedOptions

Свойства

NotifyOptions

Свойства

OpenedFile

Свойства

OpenFileMode

Перечисление

OpenFileRequestedOptions

Свойства

ProviderError

Перечисление

ReadDirectoryRequestedOptions

Свойства

ReadFileRequestedOptions

Свойства

RemoveWatcherRequestedOptions

Свойства

TruncateRequestedOptions

Свойства

UnmountOptions

Свойства

UnmountRequestedOptions

Свойства

Watcher

Свойства

WriteFileRequestedOptions

Свойства

Методы

get()

chrome.fileSystemProvider