chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.fileSystemProvider para criar sistemas de arquivos que podem ser acessados no gerenciador de arquivos no ChromeOS.

Permissões

fileSystemProvider

Disponibilidade

Somente no ChromeOS

Manifesto

É necessário declarar a permissão e a seção "fileSystemProvider" no manifesto da extensão para usar a API File System Provider. Exemplo:

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

A seção file_system_provider precisa ser declarada da seguinte forma:

configurable (booleano): opcional
Se a configuração via onConfigureRequested é compatível. Por padrão: false.
multiple_mounts (booleano): opcional
Se há suporte para vários (mais de um) sistemas de arquivos montados. Por padrão: false.
watchable (booleano): opcional
Se é possível definir observadores e notificar sobre mudanças. Por padrão: false.
source (tipo enumerado de "file", "device" ou "network"): obrigatório
Origem dos dados para sistemas de arquivos montados.

O app Files usa as informações acima para renderizar os elementos da interface relacionados de forma adequada. Por exemplo, se configurable for definido como verdadeiro, um item de menu para configurar volumes será renderizado. Da mesma forma, se multiple_mounts estiver definido como true, o app Arquivos vai permitir a adição de mais de um ponto de montagem na interface. Se watchable for false, um botão de atualização será renderizado. Se possível, adicione suporte para observadores, para que as mudanças no sistema de arquivos sejam refletidas de forma imediata e automática.

Visão geral

A API File System Provider permite que as extensões ofereçam suporte a sistemas de arquivos virtuais, que estão disponíveis no gerenciador de arquivos do ChromeOS. Os casos de uso incluem descompactar arquivos e acessar arquivos em um serviço de nuvem que não seja o Drive.

Montar sistemas de arquivos.

As extensões de fornecimento podem fornecer conteúdo do sistema de arquivos de uma fonte externa (como um servidor remoto ou um dispositivo USB) ou usar um arquivo local (como um arquivo compactado) como entrada.

Para gravar sistemas de arquivos que são gerenciadores de arquivos (a origem é "file"), o provedor precisa ser um app empacotado, já que o evento onLaunched não está disponível para extensões.

Se a origem for uma rede ou um dispositivo, o sistema de arquivos precisará ser montado quando o evento onMountRequested for chamado.

Origem dos dados do sistema de arquivos Ponto de entrada
"file" Disponível apenas para apps empacotados.
"device" ou "network" onMountRequested

Como configurar sistemas de arquivos

Os sistemas de arquivos fornecidos, depois de montados, podem ser configurados pelo evento onConfigureRequested. É especialmente útil para sistemas de arquivos que fornecem conteúdo pela rede para definir as credenciais adequadas. O processamento desse evento é opcional.

Ciclo de vida

Depois de montados, os sistemas de arquivos fornecidos são lembrados pelo Chrome e remontados automaticamente após a reinicialização. Portanto, depois que um sistema de arquivos é montado por uma extensão de fornecimento, ele permanece até que a extensão seja descarregada ou chame o método unmount.

Tipos

AbortRequestedOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • operationRequestId

    número

    Um ID da solicitação a ser cancelada.

  • requestId

    número

    O identificador exclusivo desta solicitação.

Action

Chrome 45+

Propriedades

  • ID

    string

    O identificador da ação. Qualquer string ou CommonActionId para ações comuns.

  • título

    string opcional

    O título da ação. Ele pode ser ignorado em ações comuns.

AddWatcherRequestedOptions

Propriedades

  • entryPath

    string

    O caminho da entrada a ser observada.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • recursive

    booleano

    Se a observação deve incluir todas as entradas filhas de forma recursiva. Ele só pode ser verdadeiro para diretórios.

  • requestId

    número

    O identificador exclusivo desta solicitação.

Change

Propriedades

  • changeType

    ChangeType

    O tipo de alteração que ocorreu na entrada.

  • cloudFileInfo

    CloudFileInfo opcional

    Chrome 125+

    Informações relacionadas ao arquivo, se ele estiver em um sistema de arquivos na nuvem.

  • entryPath

    string

    O caminho da entrada alterada.

ChangeType

Tipo de mudança detectada no diretório observado.

Enumeração

"CHANGED"

"DELETED"

CloseFileRequestedOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • openRequestId

    número

    Um ID de solicitação usado para abrir o arquivo.

  • requestId

    número

    O identificador exclusivo desta solicitação.

CloudFileInfo

Chrome 125+

Propriedades

  • versionTag

    string opcional

    Uma tag que representa a versão do arquivo.

CloudIdentifier

Chrome 117+

Propriedades

  • ID

    string

    O identificador do provedor para o arquivo/diretório em questão.

  • providerName

    string

    Identificador do provedor de armazenamento em nuvem (por exemplo, "drive.google.com").

CommonActionId

Chrome 45+

Lista de ações comuns. O "SHARE" é para compartilhar arquivos com outras pessoas. "SAVE_FOR_OFFLINE" para fixar (salvar para acesso off-line). "OFFLINE_NOT_NECESSARY" para notificar que o arquivo não precisa mais ser armazenado para acesso off-line. Usado por onGetActionsRequested e onExecuteActionRequested.

Enumeração

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"COMPARTILHAR"

ConfigureRequestedOptions

Chrome 44+

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos a ser configurado.

  • requestId

    número

    O identificador exclusivo desta solicitação.

CopyEntryRequestedOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • requestId

    número

    O identificador exclusivo desta solicitação.

  • sourcePath

    string

    O caminho de origem da entrada a ser copiada.

  • targetPath

    string

    O caminho de destino para a operação de cópia.

CreateDirectoryRequestedOptions

Propriedades

  • directoryPath

    string

    O caminho do diretório a ser criado.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • recursive

    booleano

    Se a operação é recursiva (somente para diretórios).

  • requestId

    número

    O identificador exclusivo desta solicitação.

CreateFileRequestedOptions

Propriedades

  • filePath

    string

    O caminho do arquivo a ser criado.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • requestId

    número

    O identificador exclusivo desta solicitação.

DeleteEntryRequestedOptions

Propriedades

  • entryPath

    string

    O caminho da entrada a ser excluída.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • recursive

    booleano

    Se a operação é recursiva (somente para diretórios).

  • requestId

    número

    O identificador exclusivo desta solicitação.

EntryMetadata

Propriedades

  • cloudFileInfo

    CloudFileInfo opcional

    Chrome 125+

    Informações que identificam um arquivo específico no sistema de arquivos em nuvem. Precisa ser fornecido se solicitado em options e o arquivo estiver armazenado em nuvem.

  • cloudIdentifier

    CloudIdentifier opcional

    Chrome 117+

    Representação do Cloud Storage dessa entrada. Precisa ser fornecido se solicitado em options e o arquivo estiver armazenado em nuvem. Para arquivos locais que não têm backup no armazenamento em nuvem, ele precisa ser indefinido quando solicitado.

  • isDirectory

    booleano opcional

    Verdadeiro se for um diretório. Precisa ser fornecido se solicitado em options.

  • mimeType

    string opcional

    Tipo MIME da entrada. Sempre opcional, mas precisa ser fornecido se solicitado em options.

  • modificationTime

    Data opcional

    A hora da última modificação desta entrada. Precisa ser fornecido se solicitado em options.

  • nome

    string opcional

    Nome desta entrada (não o nome do caminho completo). Não pode conter "/". Para a raiz, precisa estar vazio. Precisa ser fornecido se solicitado em options.

  • tamanho

    número optional

    Tamanho do arquivo em bytes. Precisa ser fornecido se solicitado em options.

  • miniatura

    string opcional

    Imagem em miniatura como um URI de dados no formato PNG, JPEG ou WEBP, com no máximo 32 KB. Opcional, mas só pode ser fornecido quando solicitado explicitamente pelo evento onGetMetadataRequested.

ExecuteActionRequestedOptions

Chrome 45+

Propriedades

  • actionId

    string

    O identificador da ação a ser executada.

  • entryPaths

    string[]

    Chrome 47+

    O conjunto de caminhos das entradas que serão usadas para a ação.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • requestId

    número

    O identificador exclusivo desta solicitação.

FileSystemInfo

Propriedades

  • displayName

    string

    Um nome legível por humanos para o sistema de arquivos.

  • fileSystemId

    string

    O identificador do sistema de arquivos.

  • openedFiles

    OpenedFile[]

    Lista de arquivos abertos no momento.

  • openedFilesLimit

    número

    O número máximo de arquivos que podem ser abertos ao mesmo tempo. Se for 0, não há limite.

  • supportsNotifyTag

    booleano opcional

    Chrome 45+

    Se o sistema de arquivos é compatível com o campo tag para observar diretórios.

  • observadores

    Watcher[]

    Chrome 45+

    Lista de observadores.

  • gravável

    booleano

    Se o sistema de arquivos é compatível com operações que podem mudar o conteúdo dele, como criar, excluir ou gravar arquivos.

GetActionsRequestedOptions

Chrome 45+

Propriedades

  • entryPaths

    string[]

    Chrome 47+

    Lista de caminhos de entradas para a lista de ações.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • requestId

    número

    O identificador exclusivo desta solicitação.

GetMetadataRequestedOptions

Propriedades

  • cloudFileInfo

    booleano

    Chrome 125+

    Defina como true se o valor cloudFileInfo for solicitado.

  • cloudIdentifier

    booleano

    Chrome 117+

    Defina como true se o valor cloudIdentifier for solicitado.

  • entryPath

    string

    O caminho da entrada para buscar metadados.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • isDirectory

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor is_directory for solicitado.

  • mimeType

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor mimeType for solicitado.

  • modificationTime

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor modificationTime for solicitado.

  • nome

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor name for solicitado.

  • requestId

    número

    O identificador exclusivo desta solicitação.

  • tamanho

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor size for solicitado.

  • miniatura

    booleano

    Defina como true se o valor thumbnail for solicitado.

MountOptions

Propriedades

  • displayName

    string

    Um nome legível por humanos para o sistema de arquivos.

  • fileSystemId

    string

    O identificador de string do sistema de arquivos. Precisa ser exclusivo para cada extensão.

  • openedFilesLimit

    número optional

    O número máximo de arquivos que podem ser abertos ao mesmo tempo. Se não for especificado ou for 0, não haverá limite.

  • permanente

    booleano opcional

    Chrome 64 ou mais recente

    Se o framework deve retomar o sistema de arquivos na próxima sessão de login. "True" por padrão.

  • supportsNotifyTag

    booleano opcional

    Chrome 45+

    Se o sistema de arquivos é compatível com o campo tag para diretórios observados.

  • gravável

    booleano opcional

    Se o sistema de arquivos é compatível com operações que podem mudar o conteúdo dele, como criar, excluir ou gravar arquivos.

MoveEntryRequestedOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • requestId

    número

    O identificador exclusivo desta solicitação.

  • sourcePath

    string

    O caminho de origem da entrada a ser movida para um novo local.

  • targetPath

    string

    O caminho de destino para a operação de cópia.

NotifyOptions

Propriedades

  • changeType

    ChangeType

    O tipo de mudança que ocorreu na entrada observada. Se for DELETED, a entrada observada será removida automaticamente da lista de entradas observadas.

  • muda

    Change[] opcional

    Lista de mudanças nas entradas do diretório observado (incluindo a própria entrada)

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a essa mudança.

  • observedPath

    string

    O caminho da entrada observada.

  • recursive

    booleano

    Modo da entrada observada.

  • tag

    string opcional

    Tag da notificação. Obrigatório se o sistema de arquivos foi montado com a opção supportsNotifyTag. Essa flag é necessária para fornecer notificações sobre mudanças que ocorreram mesmo quando o sistema estava desligado.

OpenedFile

Propriedades

  • filePath

    string

    O caminho do arquivo aberto.

  • Se o arquivo foi aberto para leitura ou gravação.

  • openRequestId

    número

    Um ID de solicitação a ser usado por solicitações consecutivas de leitura/gravação e fechamento.

OpenFileMode

Modo de abertura de um arquivo. Usado por onOpenFileRequested.

Enumeração

"READ"

"WRITE"

OpenFileRequestedOptions

Propriedades

  • filePath

    string

    O caminho do arquivo a ser aberto.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • Se o arquivo será usado para leitura ou gravação.

  • requestId

    número

    Um ID de solicitação que será usado por solicitações consecutivas de leitura/gravação e fechamento.

ProviderError

Códigos do erro usados pelas extensões em resposta a solicitações e em caso de erros ao chamar métodos da API. Para que o processo seja bem-sucedido, use "OK".

Enumeração

"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

Propriedades

  • directoryPath

    string

    O caminho do diretório em que o conteúdo é solicitado.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • isDirectory

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor is_directory for solicitado.

  • mimeType

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor mimeType for solicitado.

  • modificationTime

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor modificationTime for solicitado.

  • nome

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor name for solicitado.

  • requestId

    número

    O identificador exclusivo desta solicitação.

  • tamanho

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor size for solicitado.

  • miniatura

    booleano

    Chrome 49 ou mais recente

    Defina como true se o valor thumbnail for solicitado.

ReadFileRequestedOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • comprimento

    número

    Número de bytes a serem retornados.

  • offset

    número

    Posição no arquivo (em bytes) para iniciar a leitura.

  • openRequestId

    número

    Um ID de solicitação usado para abrir o arquivo.

  • requestId

    número

    O identificador exclusivo desta solicitação.

RemoveWatcherRequestedOptions

Propriedades

  • entryPath

    string

    O caminho da entrada monitorada.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • recursive

    booleano

    Modo do observador.

  • requestId

    número

    O identificador exclusivo desta solicitação.

TruncateRequestedOptions

Propriedades

  • filePath

    string

    O caminho do arquivo a ser truncado.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • comprimento

    número

    Número de bytes a serem retidos após a conclusão da operação.

  • requestId

    número

    O identificador exclusivo desta solicitação.

UnmountOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos a ser desmontado.

UnmountRequestedOptions

Propriedades

  • fileSystemId

    string

    O identificador do sistema de arquivos a ser desmontado.

  • requestId

    número

    O identificador exclusivo desta solicitação.

Watcher

Propriedades

  • entryPath

    string

    O caminho da entrada que está sendo observada.

  • lastTag

    string opcional

    Tag usada pela última notificação para o observador.

  • recursive

    booleano

    Se a observação deve incluir todas as entradas filhas de forma recursiva. Ele só pode ser verdadeiro para diretórios.

WriteFileRequestedOptions

Propriedades

  • dados

    ArrayBuffer

    Buffer de bytes a serem gravados no arquivo.

  • fileSystemId

    string

    O identificador do sistema de arquivos relacionado a esta operação.

  • offset

    número

    Posição no arquivo (em bytes) para começar a gravar os bytes.

  • openRequestId

    número

    Um ID de solicitação usado para abrir o arquivo.

  • requestId

    número

    O identificador exclusivo desta solicitação.

Métodos

get()

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

Retorna informações sobre um sistema de arquivos com o fileSystemId transmitido.

Parâmetros

  • fileSystemId

    string

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (fileSystem: FileSystemInfo) => void

Retorna

  • Promise<FileSystemInfo>

    Chrome 96 ou mais recente

    Callback para receber o resultado da função get.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getAll()

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

Retorna todos os sistemas de arquivos montados pela extensão.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (fileSystems: FileSystemInfo[]) => void

Retorna

  • Promise<FileSystemInfo[]>

    Chrome 96 ou mais recente

    Callback para receber o resultado da função getAll.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

mount()

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

Monta um sistema de arquivos com os fileSystemId e displayName fornecidos. displayName vai aparecer no painel esquerdo do app Arquivos. displayName pode conter qualquer caractere, incluindo "/", mas não pode ser uma string vazia. displayName precisa ser descritivo, mas não precisa ser exclusivo. O fileSystemId não pode ser uma string vazia.

Dependendo do tipo de sistema de arquivos que está sendo montado, a opção source precisa ser definida adequadamente.

Em caso de erro, runtime.lastError será definido com um código do erro correspondente.

Parâmetros

  • opções

    MountOptions

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Um callback de resultado genérico para indicar sucesso ou falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

notify()

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

Notifica sobre mudanças no diretório monitorado em observedPath no modo recursive. Se o sistema de arquivos for montado com supportsNotifyTag, tag precisará ser fornecido, e todas as mudanças desde a última notificação sempre serão informadas, mesmo que o sistema tenha sido desligado. A última tag pode ser recebida com getAll.

Para usar, a opção de manifesto file_system_provider.notify precisa ser definida como verdadeira.

O valor de tag pode ser qualquer string exclusiva por chamada, para que seja possível identificar a última notificação registrada. Por exemplo, se a extensão de fornecimento for iniciada após uma reinicialização e a tag da última notificação registrada for igual a "123", ela precisará chamar notify para todas as mudanças que ocorreram desde a mudança marcada como "123". Não pode ser uma string vazia.

Nem todos os provedores podem fornecer uma tag, mas se o sistema de arquivos tiver um registro de alterações, a tag poderá ser, por exemplo, um número de alteração ou de revisão.

Se um diretório pai for removido, todas as entradas descendentes também serão removidas. Se elas forem monitoradas, a API precisará ser notificada sobre o fato. Além disso, se um diretório for renomeado, todas as entradas descendentes serão removidas, já que não há mais entradas nos caminhos originais.

Em caso de erro, runtime.lastError será definido com um código do erro correspondente.

Parâmetros

  • opções

    NotifyOptions

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Um callback de resultado genérico para indicar sucesso ou falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

unmount()

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

Desativa um sistema de arquivos com o fileSystemId fornecido. Ele precisa ser chamado depois que onUnmountRequested é invocado. Além disso, a extensão de fornecimento pode decidir realizar a desmontagem se não for solicitada (por exemplo, em caso de perda de conexão ou erro de arquivo).

Em caso de erro, runtime.lastError será definido com um código do erro correspondente.

Parâmetros

  • opções

    UnmountOptions

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Um callback de resultado genérico para indicar sucesso ou falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onAbortRequested

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

Gerado quando o cancelamento de uma operação com operationRequestId é solicitado. A operação executada com operationRequestId precisa ser interrompida imediatamente, e o successCallback dessa solicitação de cancelamento precisa ser executado. Se o cancelamento falhar, errorCallback precisará ser chamado. Os callbacks da operação cancelada não podem ser chamados, porque serão ignorados. Apesar de chamar errorCallback, a solicitação pode ser cancelada à força.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      função

      O parâmetro successCallback é semelhante a: 

      () => void

    • errorCallback

      função

      O parâmetro errorCallback é semelhante a: 

      (error: ProviderError) => void

onAddWatcherRequested

Chrome 45+ 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Gerado quando a configuração de um novo observador de diretório é solicitada. Se ocorrer um erro, errorCallback precisará ser chamado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void

onCloseFileRequested

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

Gerado quando um arquivo aberto anteriormente com openRequestId é solicitado para ser fechado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void

onConfigureRequested

Chrome 44+ 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Gerado quando é solicitada a exibição de uma caixa de diálogo de configuração para fileSystemId. Se for processada, a opção de manifesto file_system_provider.configurable precisa ser definida como verdadeira.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void

onCopyEntryRequested

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

Gerado quando a cópia de uma entrada (recursivamente, se for um diretório) é solicitada. Se ocorrer um erro, errorCallback precisará ser chamado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void

onCreateDirectoryRequested

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

Gerado quando a criação de um diretório é solicitada. A operação precisa falhar com o erro EXISTS se o diretório de destino já existir. Se recursive for verdadeiro, todos os diretórios ausentes no caminho do diretório precisarão ser criados.

Parâmetros

onCreateFileRequested

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

Gerado quando a criação de um arquivo é solicitada. Se o arquivo já existir, errorCallback precisará ser chamado com o código do erro "EXISTS".

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void

onDeleteEntryRequested

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

Gerado quando a exclusão de uma entrada é solicitada. Se recursive for verdadeiro e a entrada for um diretório, todas as entradas dentro dele também precisarão ser excluídas de forma recursiva.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void

onExecuteActionRequested

Chrome 48 ou mais recente 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Gerado quando a execução de uma ação para um conjunto de arquivos ou diretórios é solicitada. Depois que a ação for concluída, successCallback precisa ser chamado. Em caso de erro, errorCallback precisa ser chamado.

Parâmetros

onGetActionsRequested

Chrome 48 ou mais recente 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Gerado quando uma lista de ações para um conjunto de arquivos ou diretórios em entryPaths é solicitada. Todas as ações retornadas precisam ser aplicáveis a cada entrada. Se não houver ações desse tipo, uma matriz vazia será retornada. As ações precisam ser retornadas com a chamada successCallback. Em caso de erro, errorCallback precisa ser chamado.

Parâmetros

onGetMetadataRequested

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

Gerado quando os metadados de um arquivo ou diretório em entryPath são solicitados. Os metadados precisam ser retornados com a chamada successCallback. Em caso de erro, errorCallback precisa ser chamado.

Parâmetros

onMountRequested

Chrome 44+ 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Gerado quando é solicitado que uma caixa de diálogo seja mostrada para montar um novo sistema de arquivos. Se a extensão/app for um gerenciador de arquivos, esse evento não deverá ser processado. Em vez disso, app.runtime.onLaunched precisa ser processado para montar novos sistemas de arquivos quando um arquivo é aberto. Para várias montagens, a opção de manifesto file_system_provider.multiple_mounts precisa ser definida como verdadeira.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (successCallback: function, errorCallback: function) => void

    • successCallback

      função

      O parâmetro successCallback é semelhante a: 

      () => void

    • errorCallback

      função

      O parâmetro errorCallback é semelhante a: 

      (error: ProviderError) => void

onMoveEntryRequested

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

Gerado quando a movimentação de uma entrada (recursivamente, se for um diretório) é solicitada. Se ocorrer um erro, errorCallback precisará ser chamado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void

onOpenFileRequested

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

Gerado quando a abertura de um arquivo em filePath é solicitada. Se o arquivo não existir, a operação vai falhar. O número máximo de arquivos abertos de uma só vez pode ser especificado com MountOptions.

Parâmetros

onReadDirectoryRequested

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

Gerado quando o conteúdo de um diretório em directoryPath é solicitado. Os resultados precisam ser retornados em blocos chamando o successCallback várias vezes. Em caso de erro, errorCallback precisa ser chamado.

Parâmetros

onReadFileRequested

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

Gerado quando a leitura do conteúdo de um arquivo aberto anteriormente com openRequestId é solicitada. Os resultados precisam ser retornados em blocos chamando successCallback várias vezes. Em caso de erro, errorCallback precisa ser chamado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      função

      O parâmetro successCallback é semelhante a: 

      (data: ArrayBuffer, hasMore: boolean) => void

      • dados

        ArrayBuffer

      • hasMore

        booleano

    • errorCallback

      função

      O parâmetro errorCallback é semelhante a: 

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45+ 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

Gerado quando o observador precisa ser removido. Se ocorrer um erro, errorCallback precisará ser chamado.

Parâmetros

onTruncateRequested

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

Gerado quando é solicitado o truncamento de um arquivo para um tamanho desejado. Se ocorrer um erro, errorCallback precisará ser chamado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void

onUnmountRequested

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

Gerado quando a desmontagem do sistema de arquivos com o identificador fileSystemId é solicitada. Na resposta, o método da API unmount precisa ser chamado junto com successCallback. Se não for possível desmontar (por exemplo, devido a uma operação pendente), errorCallback precisará ser chamado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void

onWriteFileRequested

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

Gerado quando é solicitada a gravação de conteúdo em um arquivo aberto anteriormente com openRequestId.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void