chrome.fileSystemProvider

.

Descripción

Usa la API de chrome.fileSystemProvider para crear sistemas de archivos, a los que se puede acceder desde el administrador de archivos en ChromeOS.

Permisos

fileSystemProvider

Disponibilidad

Solo en ChromeOS

Manifiesto

Debes declarar el "fileSystemProvider" permiso y sección del manifiesto de extensión para usar la API de File System Provider Por ejemplo:

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

La sección file_system_provider se debe declarar de la siguiente manera:

configurable (booleano): opcional
Si se admite la configuración mediante onConfigureRequested De forma predeterminada, el valor es falso.
multiple_mounts (booleano): opcional
Indica si se admiten varios (más de uno) sistemas de archivos activados. De forma predeterminada, el valor es falso.
watchable (booleano): opcional
Indica si se admite la configuración de supervisores y la notificación sobre los cambios. De forma predeterminada, el valor es falso.
source (enum. de "file", "device" o "network"): obligatorio
Fuente de datos para sistemas de archivos activados.

La app de Files usa la información anterior para renderizar los elementos relacionados de la IU de manera adecuada. Por ejemplo, si se establece configurable como verdadero, se renderizará un elemento de menú para configurar volúmenes. De manera similar, si estableces multiple_mounts como true, la app de Archivos permitirá agregar más de un punto de activación desde la IU. Si watchable es false, se renderizará un botón de actualización. Ten en cuenta que, si es posible, debes agregar compatibilidad para observadores, de modo que los cambios en el sistema de archivos se puedan reflejar de inmediato y automáticamente.

Descripción general

La API de File System Provider permite que las extensiones sean compatibles con los sistemas de archivos virtuales, que están disponibles en el administrador de archivos de ChromeOS. Los casos de uso incluyen la descompresión de archivos y el acceso a ellos en un servicio en la nube que no sea Drive.

Activar sistemas de archivos

Las extensiones que se proporcionan pueden incluir contenido del sistema de archivos desde una fuente externa (como un servidor remoto o un dispositivo USB) o utilizar un archivo local (como un archivo) como entrada.

Para escribir sistemas de archivos que sean controladores de archivos (el origen es "file"), el proveedor debe ser una app empaquetada, ya que el evento onLaunched no está disponible para las extensiones.

Si la fuente es una red o un dispositivo, el sistema de archivos debería activarse cuando se llame al evento onMountRequested.

La fuente de los datos del sistema de archivos Punto de entrada
"file" Disponible solo para aplicaciones empaquetadas.
"device" o "network" onMountRequested

Configurar sistemas de archivos

Los sistemas de archivos proporcionados una vez activados se pueden configurar a través del evento onConfigureRequested. Es especialmente útil para sistemas de archivos que proporcionan contenido a través de la red para establecer las credenciales adecuadas. El control de este evento es opcional.

Ciclo de vida

Chrome recuerda los sistemas de archivos proporcionados una vez activados y se vuelven a activar automáticamente después de reiniciarlos o reiniciarlos. Por lo tanto, una vez que una extensión proporcional activa un sistema de archivos, este permanecerá hasta que se descargue la extensión o hasta que llame al método unmount.

Tipos

AbortRequestedOptions

Propiedades

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • operationRequestId

    número

    Un ID de la solicitud que se anulará.

  • requestId

    número

    Es el identificador único de esta solicitud.

Action

Chrome 45 y versiones posteriores

Propiedades

  • id

    string

    Es el identificador de la acción. Cualquier cadena o CommonActionId para acciones comunes

  • título

    string opcional

    Es el título de la acción. Es posible que se ignore para acciones comunes.

AddWatcherRequestedOptions

Propiedades

  • entryPath

    string

    Es la ruta de la entrada que se debe observar.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • Recurrente

    boolean

    Si la observación debe incluir todas las entradas secundarias de forma recursiva. Solo puede ser verdadera para los directorios.

  • requestId

    número

    Es el identificador único de esta solicitud.

Change

Propiedades

  • changeType

    El tipo de cambio que se produjo en la entrada.

  • cloudFileInfo

    CloudFileInfo opcional

    Chrome 125 y versiones posteriores

    Información relacionada con el archivo si está respaldada por un sistema de archivos en la nube.

  • entryPath

    string

    La ruta de la entrada modificada.

ChangeType

Tipo de cambio detectado en el directorio observado.

Enum

“CAMBIADO”

"BORRADO"

CloseFileRequestedOptions

Propiedades

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • openRequestId

    número

    Un ID de solicitud que se usa para abrir el archivo.

  • requestId

    número

    Es el identificador único de esta solicitud.

CloudFileInfo

Chrome 125 y versiones posteriores

Propiedades

  • versionTag

    string opcional

    Es una etiqueta que representa la versión del archivo.

CloudIdentifier

Chrome 117 y versiones posteriores

Propiedades

  • id

    string

    El identificador del proveedor para el archivo o directorio determinado.

  • providerName

    string

    Es el identificador del proveedor de almacenamiento en la nube (p.ej., “drive.google.com”).

CommonActionId

Chrome 45 y versiones posteriores

Lista de acciones comunes. "SHARE" es para compartir archivos con otros usuarios. "SAVE_FOR_OFFLINE" para fijar (se guarda para el acceso sin conexión) "OFFLINE_NOT_NECESSARY" para notificar que ya no es necesario almacenar el archivo para el acceso sin conexión. Lo usan onGetActionsRequested y onExecuteActionRequested.

Enum

“SAVE_FOR_OFFLINE”

"OFFLINE_NOT_NECESSARY"

“COMPARTIR”

ConfigureRequestedOptions

Chrome 44 y versiones posteriores

Propiedades

  • fileSystemId

    string

    Es el identificador del sistema de archivos que se configurará.

  • requestId

    número

    Es el identificador único de esta solicitud.

CopyEntryRequestedOptions

Propiedades

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

  • sourcePath

    string

    La ruta de acceso de origen de la entrada que se copiará.

  • targetPath

    string

    La ruta de destino para la operación de copia.

CreateDirectoryRequestedOptions

Propiedades

  • directoryPath

    string

    La ruta de acceso del directorio que se creará.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • Recurrente

    boolean

    Indica si la operación es recursiva (solo para directorios).

  • requestId

    número

    Es el identificador único de esta solicitud.

CreateFileRequestedOptions

Propiedades

  • filePath

    string

    La ruta de acceso del archivo que se creará.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

DeleteEntryRequestedOptions

Propiedades

  • entryPath

    string

    La ruta de acceso de la entrada que se borrará.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • Recurrente

    boolean

    Indica si la operación es recursiva (solo para directorios).

  • requestId

    número

    Es el identificador único de esta solicitud.

EntryMetadata

Propiedades

  • cloudFileInfo

    CloudFileInfo opcional

    Chrome 125 y versiones posteriores

    Información que identifica un archivo específico en el sistema subyacente de archivos en la nube. Se debe proporcionar si se solicita en options y el archivo está respaldado por el almacenamiento en la nube.

  • cloudIdentifier

    CloudIdentifier opcional

    Chrome 117 y versiones posteriores

    Representación de esta entrada en Cloud Storage. Se debe proporcionar si se solicita en options y el archivo está respaldado por el almacenamiento en la nube. En el caso de los archivos locales que no estén respaldados por el almacenamiento en la nube, no deberían estar definidos cuando se soliciten.

  • isDirectory

    booleano opcional

    Verdadero si se trata de un directorio. Se debe proporcionar si se solicita en options.

  • mimeType

    string opcional

    Tipo MIME de la entrada. Siempre es opcional, pero se debe proporcionar si se solicita en options.

  • modificationTime

    Fecha opcional

    La hora de la última modificación de esta entrada. Se debe proporcionar si se solicita en options.

  • nombre

    string opcional

    Es el nombre de esta entrada (no el nombre completo de la ruta de acceso). No debe contener “/”. Para la raíz, debe estar vacío. Se debe proporcionar si se solicita en options.

  • tamaño

    número opcional

    Tamaño del archivo en bytes. Se debe proporcionar si se solicita en options.

  • miniatura

    string opcional

    Imagen en miniatura como un URI de datos en formato PNG, JPEG o WEBP, con un tamaño máximo de 32 KB. Opcional, pero se puede proporcionar solo cuando el evento onGetMetadataRequested lo solicita de manera explícita.

ExecuteActionRequestedOptions

Chrome 45 y versiones posteriores

Propiedades

  • actionId

    string

    Es el identificador de la acción que se ejecutará.

  • entryPaths

    string[]

    Chrome 47 y versiones posteriores

    El conjunto de rutas de acceso de las entradas que se usarán para la acción.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

FileSystemInfo

Propiedades

  • displayName

    string

    Es un nombre legible para el sistema de archivos.

  • fileSystemId

    string

    Es el identificador del sistema de archivos.

  • openedFiles

    Lista de archivos abiertos actualmente.

  • openedFilesLimit

    número

    La cantidad máxima de archivos que se pueden abrir a la vez. Si es 0, entonces no se limita.

  • supportsNotifyTag

    booleano opcional

    Chrome 45 y versiones posteriores

    Indica si el sistema de archivos admite el campo tag para observar directorios.

  • observadores
    Chrome 45 y versiones posteriores

    Lista de supervisores.

  • admite escritura

    boolean

    Si el sistema de archivos admite operaciones que pueden cambiar el contenido del sistema (como crear, borrar o escribir en archivos).

GetActionsRequestedOptions

Chrome 45 y versiones posteriores

Propiedades

  • entryPaths

    string[]

    Chrome 47 y versiones posteriores

    Lista de rutas de acceso de entradas para la lista de acciones.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

GetMetadataRequestedOptions

Propiedades

  • cloudFileInfo

    boolean

    Chrome 125 y versiones posteriores

    Se establece en true si se solicita el valor cloudFileInfo.

  • cloudIdentifier

    boolean

    Chrome 117 y versiones posteriores

    Se establece en true si se solicita el valor cloudIdentifier.

  • entryPath

    string

    La ruta de acceso de la entrada sobre la que se recuperarán los metadatos.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • isDirectory

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor is_directory.

  • mimeType

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor mimeType.

  • modificationTime

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor modificationTime.

  • nombre

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor name.

  • requestId

    número

    Es el identificador único de esta solicitud.

  • tamaño

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor size.

  • miniatura

    boolean

    Se establece en true si se solicita el valor thumbnail.

MountOptions

Propiedades

  • displayName

    string

    Es un nombre legible para el sistema de archivos.

  • fileSystemId

    string

    El identificador de cadenas del sistema de archivos. Debe ser único para cada extensión.

  • openedFilesLimit

    número opcional

    La cantidad máxima de archivos que se pueden abrir a la vez. Si no se especifica, o es 0, entonces no se limita.

  • persistentes

    booleano opcional

    Chrome 64 y versiones posteriores

    Indica si el framework debe reanudar el sistema de archivos en la próxima sesión de acceso. Verdadero de forma predeterminada.

  • supportsNotifyTag

    booleano opcional

    Chrome 45 y versiones posteriores

    Indica si el sistema de archivos admite el campo tag para los directorios observados.

  • admite escritura

    booleano opcional

    Si el sistema de archivos admite operaciones que pueden cambiar el contenido del sistema (como crear, borrar o escribir en archivos).

MoveEntryRequestedOptions

Propiedades

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

  • sourcePath

    string

    La ruta de acceso de origen de la entrada que se moverá a un lugar nuevo.

  • targetPath

    string

    La ruta de destino para la operación de copia.

NotifyOptions

Propiedades

  • changeType

    Es el tipo de cambio que se produjo en la entrada observada. Si es DELETED, la entrada observada se quitará automáticamente de la lista de entradas observadas.

  • Cambios

    Cambio[] opcional

    Lista de cambios en las entradas dentro del directorio observado (incluida la entrada en sí)

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con este cambio.

  • observedPath

    string

    Es la ruta de la entrada observada.

  • Recurrente

    boolean

    Modo de la entrada observada.

  • etiqueta

    string opcional

    Etiqueta de la notificación. Es obligatorio si el sistema de archivos se activó con la opción supportsNotifyTag. Ten en cuenta que esta marca es necesaria para proporcionar notificaciones sobre los cambios que cambiaron incluso cuando se apagó el sistema.

OpenedFile

Propiedades

  • filePath

    string

    Es la ruta de acceso del archivo abierto.

  • Standard

    Si el archivo se abrió para lectura o escritura

  • openRequestId

    número

    Un ID de solicitud que usarán las solicitudes consecutivas de lectura y escritura y de cierre.

OpenFileMode

Modo de abrir un archivo. Lo usa onOpenFileRequested.

Enum

“LEER”

“ESCRITURA”

OpenFileRequestedOptions

Propiedades

  • filePath

    string

    La ruta del archivo que se abrirá.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • Standard

    Si el archivo se usará para lectura o escritura.

  • requestId

    número

    Un ID de solicitud que usarán las solicitudes consecutivas de lectura y escritura y de cierre.

ProviderError

Códigos de error que se usan al proporcionar extensiones en respuesta a solicitudes y en caso de errores cuando se llama a los métodos de la API. Para que se realice correctamente, se debe usar "OK".

Enum

“Aceptar”

"ERROR"

“IN_USE”

"EXISTE"

"NOT_FOUND"

"ACCESS_DENIED"

“TOO_MANY_OPENED”

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

“INVALID_OPERATION”

"SEGURIDAD"

“ABORT”

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Propiedades

  • directoryPath

    string

    Es la ruta de acceso del directorio cuyo contenido se solicita.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • isDirectory

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor is_directory.

  • mimeType

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor mimeType.

  • modificationTime

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor modificationTime.

  • nombre

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor name.

  • requestId

    número

    Es el identificador único de esta solicitud.

  • tamaño

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor size.

  • miniatura

    boolean

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor thumbnail.

ReadFileRequestedOptions

Propiedades

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • longitud

    número

    Cantidad de bytes que se mostrarán.

  • offset

    número

    Posición en el archivo (en bytes) desde la que se empieza a leer.

  • openRequestId

    número

    Un ID de solicitud que se usa para abrir el archivo.

  • requestId

    número

    Es el identificador único de esta solicitud.

RemoveWatcherRequestedOptions

Propiedades

  • entryPath

    string

    Es la ruta de acceso de la entrada visualizada.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • Recurrente

    boolean

    Modo del observador.

  • requestId

    número

    Es el identificador único de esta solicitud.

TruncateRequestedOptions

Propiedades

  • filePath

    string

    La ruta del archivo que se truncará.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • longitud

    número

    Cantidad de bytes que se retendrán una vez finalizada la operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

UnmountOptions

Propiedades

  • fileSystemId

    string

    El identificador del sistema de archivos que se desactivará.

UnmountRequestedOptions

Propiedades

  • fileSystemId

    string

    El identificador del sistema de archivos que se desactivará.

  • requestId

    número

    Es el identificador único de esta solicitud.

Watcher

Propiedades

  • entryPath

    string

    La ruta de la entrada que se observa.

  • lastTag

    string opcional

    Etiqueta que usó la última notificación para el supervisor.

  • Recurrente

    boolean

    Si la visualización debe incluir todas las entradas secundarias de forma recurrente. Solo puede ser verdadera para los directorios.

WriteFileRequestedOptions

Propiedades

  • datos

    ArrayBuffer

    El búfer de bytes que se escribirán en el archivo.

  • fileSystemId

    string

    Es el identificador del sistema de archivos relacionado con esta operación.

  • offset

    número

    Posición en el archivo (en bytes) desde la que se comienzan a escribir los bytes.

  • openRequestId

    número

    Un ID de solicitud que se usa para abrir el archivo.

  • requestId

    número

    Es el identificador único de esta solicitud.

Métodos

get()

Promesa
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

Muestra información sobre un sistema de archivos con el fileSystemId pasado.

Parámetros

  • fileSystemId

    string

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera:

    (fileSystem: FileSystemInfo) => void

Muestra

  • Promise<FileSystemInfo>

    Chrome 96 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getAll()

Promesa
chrome.fileSystemProvider.getAll(
  callback?: function,
)

Muestra todos los sistemas de archivos que activó la extensión.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera:

    (fileSystems: FileSystemInfo[]) => void

Muestra

  • Promise<FileSystemInfo[]>

    Chrome 96 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

mount()

Promesa
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

Activa un sistema de archivos con los fileSystemId y displayName especificados. displayName se mostrará en el panel izquierdo de la app de Archivos. displayName puede contener cualquier carácter, incluido “/”, pero no puede ser una cadena vacía. El campo displayName debe ser descriptivo, pero no es necesario que sea único. El fileSystemId no debe ser una cadena vacía.

Según el tipo de sistema de archivos que se active, la opción source debe configurarse de forma correcta.

En caso de error, se configurará runtime.lastError con el código de error correspondiente.

Parámetros

  • opciones
  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera:

    () => void

Muestra

  • Promesa<void>

    Chrome 96 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

notify()

Promesa Chrome 45 y versiones posteriores .
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

Notifica los cambios en el directorio visualizado en observedPath en el modo recursive. Si el sistema de archivos está activado con supportsNotifyTag, se debe proporcionar tag, y todos los cambios realizados desde la última notificación siempre se informan, incluso si se cerró el sistema. La última etiqueta se puede obtener con getAll.

Para usarla, se debe establecer la opción del manifiesto file_system_provider.notify como verdadera.

El valor de tag puede ser cualquier cadena que sea única por llamada, por lo que es posible identificar la última notificación registrada. P. ej., Si la extensión que proporciona la información comienza después de un reinicio y la última etiqueta de la notificación registrada es igual a "123", debe llamar a notify para todos los cambios que ocurrieron desde el cambio etiquetado como "123". No puede ser una cadena vacía.

No todos los proveedores pueden proporcionar una etiqueta, pero si el sistema de archivos tiene un registro de cambios, la etiqueta puede ser, por ejemplo, un número de cambio o un número de revisión.

Ten en cuenta que si se quita un directorio principal, también se quitan todas las entradas subordinadas y, si se observan, se debe notificar a la API al respecto. Además, si se cambia el nombre de un directorio, entonces se quitan todas las entradas subordinadas, dado que ya no hay ninguna entrada en sus rutas de acceso originales.

En caso de error, se configurará runtime.lastError con el código de error correspondiente.

Parámetros

  • opciones
  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera:

    () => void

Muestra

  • Promesa<void>

    Chrome 96 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

unmount()

Promesa
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

Desactiva un sistema de archivos con el fileSystemId determinado. Se debe llamar después de invocar onUnmountRequested. Además, la extensión que proporciona puede decidir desactivarse si no se solicita (p. ej., en caso de pérdida de conexión o de un error de archivo).

En caso de error, se configurará runtime.lastError con el código de error correspondiente.

Parámetros

  • opciones
  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera:

    () => void

Muestra

  • Promesa<void>

    Chrome 96 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

Eventos

onAbortRequested

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

Se genera cuando se anula una operación con operationRequestId. La operación que se ejecutó con operationRequestId se debe detener de inmediato y el successCallback de esta solicitud de anulación se debe ejecutar. Si la anulación falla, se debe llamar a errorCallback. Ten en cuenta que no se deben llamar a las devoluciones de llamada de la operación anulada, ya que se ignorarán. A pesar de llamar a errorCallback, la solicitud se puede anular de manera forzosa.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onAddWatcherRequested

Chrome 45 y versiones posteriores
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Se genera cuando se solicita la configuración de un nuevo observador de directorio. Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onCloseFileRequested

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

Se genera cuando se abre un archivo que se abrió anteriormente con openRequestId y se solicita que se cierre.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onConfigureRequested

Chrome 44 y versiones posteriores
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Se genera cuando se solicita un diálogo de configuración para fileSystemId. Si se controla, la opción de manfiest file_system_provider.configurable debe configurarse como true.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onCopyEntryRequested

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

Se genera cuando se copia una entrada (de manera recurrente si se solicita un directorio). Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onCreateDirectoryRequested

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

Se genera cuando se solicita la creación de un directorio. La operación debe fallar con el error EXISTS si el directorio de destino ya existe. Si recursive es verdadero, se deben crear todos los directorios que faltan en la ruta del directorio.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

onCreateFileRequested

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

Se genera cuando se solicita la creación de un archivo. Si el archivo ya existe, debes llamar a errorCallback con el código de error "EXISTS".

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onDeleteEntryRequested

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

Se genera cuando se solicita la eliminación de una entrada. Si recursive es verdadero y la entrada es un directorio, todas las entradas dentro deben borrarse de manera recurrente.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onExecuteActionRequested

Chrome 48 y versiones posteriores
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Se genera cuando se solicita una acción para un conjunto de archivos o directorios. Una vez completada la acción, se debe llamar a successCallback. En caso de error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

onGetActionsRequested

Chrome 48 y versiones posteriores
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Se genera cuando se solicita una lista de acciones para un conjunto de archivos o directorios en entryPaths. Todas las acciones mostradas deben ser aplicables a cada entrada. Si no existen tales acciones, se debe mostrar un array vacío. Las acciones se deben mostrar con la llamada a successCallback. En caso de error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

onGetMetadataRequested

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

Se genera cuando se solicitan metadatos de un archivo o un directorio en entryPath. Los metadatos se deben mostrar con la llamada successCallback. En caso de error, se debe llamar a errorCallback.

Parámetros

onMountRequested

Chrome 44 y versiones posteriores
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Se genera cuando se muestra un diálogo para activar un nuevo sistema de archivos. Si la extensión o la aplicación es un controlador de archivos, este evento no debería controlarse. En su lugar, se debe controlar app.runtime.onLaunched para activar sistemas de archivos nuevos cuando se abre un archivo. Para varias activaciones, la opción del manifiesto file_system_provider.multiple_mounts debe establecerse como verdadera.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onMoveEntryRequested

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

Se genera cuando se mueve una entrada (de manera recurrente si se solicita un directorio). Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onOpenFileRequested

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

Se genera cuando se abre un archivo en filePath. Si el archivo no existe, la operación debe fallar. Para especificar la cantidad máxima de archivos que se pueden abrir a la vez, usa MountOptions.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

onReadDirectoryRequested

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

Se genera cuando se solicita el contenido de un directorio en directoryPath. Los resultados se deben mostrar en fragmentos llamando a successCallback varias veces. En caso de error, se debe llamar a errorCallback.

Parámetros

onReadFileRequested

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

Se genera cuando se solicita la lectura del contenido de un archivo abierto anteriormente con openRequestId. Los resultados se deben mostrar en fragmentos llamando a successCallback varias veces. En caso de error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

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

      • datos

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45 y versiones posteriores
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

Se genera cuando se debe quitar el agente de observación. Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

onTruncateRequested

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

Se genera cuando se solicita el truncamiento de un archivo para alcanzar la longitud deseada. Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onUnmountRequested

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

Se genera cuando se desactiva para el sistema de archivos con el identificador fileSystemId. En la respuesta, se debe llamar al método de la API unmount junto con successCallback. Si no es posible desactivar la función (p. ej., debido a una operación pendiente), se debe llamar a errorCallback.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void

onWriteFileRequested

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

Se genera cuando se escribe el contenido en un archivo abierto antes con openRequestId.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

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

    • successCallback

      función

      El parámetro successCallback se ve de la siguiente manera:

      () => void

    • errorCallback

      función

      El parámetro errorCallback se ve de la siguiente manera:

      (error: ProviderError) => void