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 para ChromeOS

Debes declarar el permiso y la sección "fileSystemProvider" en el 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
Determina si se admite la configuración a través de onConfigureRequested. El valor predeterminado es falso.
multiple_mounts (booleano): opcional
Determina si se admiten varios sistemas de archivos activados (más de uno). El valor predeterminado es falso.
watchable (booleano): opcional
Indica si se admite la configuración de observadores y las notificaciones sobre cambios. El valor predeterminado es falso.
source (enumeración de "file", "device" o "network") (obligatorio)
Fuente de datos para sistemas de archivos activados.

La app de Archivos usa la información anterior para renderizar correctamente los elementos de la IU relacionados. Por ejemplo, si estableces configurable como verdadero, se renderizará un elemento de menú para configurar volúmenes. Del mismo modo, si multiple_mounts se establece en 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 con supervisores, 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 admitan sistemas de archivos virtuales, que están disponibles en el administrador de archivos de ChromeOS. Los casos de uso incluyen descomprimir archivos y acceder a ellos en un servicio en la nube que no sea Drive.

Activar sistemas de archivos

Proporcionar extensiones puede proporcionar contenido del sistema de archivos desde una fuente externa (como un servidor remoto o un dispositivo USB) o mediante un archivo local (como un archivo) como entrada.

Para escribir sistemas de archivos que sean controladores de archivos (la fuente 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 debe activarse cuando se llama 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

Configura sistemas de archivos

Una vez activados, los sistemas de archivos proporcionados se pueden configurar mediante el evento onConfigureRequested. Es especialmente útil para los sistemas de archivos que proporcionan contenidos a través de la red con el fin de establecer las credenciales correctas. El control de este evento es opcional.

Ciclo de vida

Chrome recuerda los sistemas de archivos proporcionados una vez activados y los vuelve a activar automáticamente después de reiniciar o reiniciar. Por lo tanto, una vez que una extensión proveedora active el sistema de archivos, permanecerá hasta que esta se descargue o la extensión llame al método unmount.

Tipos

AbortRequestedOptions

Propiedades

  • fileSystemId

    cadena

    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

    cadena

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

  • título

    cadena opcional

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

AddWatcherRequestedOptions

Propiedades

  • entryPath

    cadena

    Es la ruta de la entrada que se observará.

  • fileSystemId

    cadena

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

  • Recurrente

    boolean

    Indica si la observación debe incluir todas las entradas secundarias de manera recursiva. Puede ser así solo para los directorios.

  • requestId

    número

    Es el identificador único de esta solicitud.

Change

Propiedades

  • changeType

    ChangeType

    El tipo de cambio que se realizó en la entrada.

  • cloudFileInfo

    CloudFileInfo opcional

    Pendiente

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

  • entryPath

    cadena

    Es la ruta de acceso de la entrada modificada.

ChangeType

Tipo de cambio detectado en el directorio observado.

Enum

CloseFileRequestedOptions

Propiedades

  • fileSystemId

    cadena

    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

Pendiente

Propiedades

  • versionTag

    cadena opcional

    Una etiqueta que representa la versión del archivo.

CloudIdentifier

Chrome 117 y versiones posteriores

Propiedades

  • id

    cadena

    Es el identificador del proveedor para el archivo o directorio determinado.

  • providerName

    cadena

    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" sirve para compartir archivos con otras personas. "SAVE_FOR_OFFLINE" para fijar (guardar para acceso sin conexión) "OFFLINE_NOT_NECESSARY" para notificar que el archivo ya no necesita almacenarse para el acceso sin conexión Lo usan onGetActionsRequested y onExecuteActionRequested.

Enum

"OFFLINE_NOT_NECESSARY"

ConfigureRequestedOptions

Chrome 44 y versiones posteriores

Propiedades

  • fileSystemId

    cadena

    El identificador del sistema de archivos que se configurará.

  • requestId

    número

    Es el identificador único de esta solicitud.

CopyEntryRequestedOptions

Propiedades

  • fileSystemId

    cadena

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

  • requestId

    número

    Es el identificador único de esta solicitud.

  • sourcePath

    cadena

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

  • targetPath

    cadena

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

CreateDirectoryRequestedOptions

Propiedades

  • directoryPath

    cadena

    La ruta de acceso del directorio que se creará.

  • fileSystemId

    cadena

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

  • Recurrente

    boolean

    Si la operación es recursiva (solo para directorios)

  • requestId

    número

    Es el identificador único de esta solicitud.

CreateFileRequestedOptions

Propiedades

  • filePath

    cadena

    Es la ruta de acceso del archivo que se creará.

  • fileSystemId

    cadena

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

  • requestId

    número

    Es el identificador único de esta solicitud.

DeleteEntryRequestedOptions

Propiedades

  • entryPath

    cadena

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

  • fileSystemId

    cadena

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

  • Recurrente

    boolean

    Si la operación es recursiva (solo para directorios)

  • requestId

    número

    Es el identificador único de esta solicitud.

EntryMetadata

Propiedades

  • cloudFileInfo

    CloudFileInfo opcional

    Pendiente

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

  • cloudIdentifier

    CloudIdentifier opcional

    Chrome 117 y versiones posteriores

    Representación de Cloud Storage de esta entrada. Se debe proporcionar si se solicita en options y el archivo está respaldado por Cloud Storage. Los archivos locales que no están respaldados por el almacenamiento en la nube, no deben definirse cuando se solicitan.

  • isDirectory

    booleano opcional

    Es verdadero si es un directorio. Se debe proporcionar si se solicita en options.

  • mimeType

    cadena opcional

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

  • modificationTime

    Fecha opcional

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

  • name

    cadena opcional

    Nombre de esta entrada (no el nombre completo de la ruta de acceso). No debe contener “/”. La raíz debe estar vacía. 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

    cadena opcional

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

ExecuteActionRequestedOptions

Chrome 45 y versiones posteriores

Propiedades

  • actionId

    cadena

    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

    cadena

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

  • requestId

    número

    Es el identificador único de esta solicitud.

FileSystemInfo

Propiedades

  • displayName

    cadena

    Es un nombre legible para el sistema de archivos.

  • fileSystemId

    cadena

    Es el identificador del sistema de archivos.

  • openedFiles

    OpenedFile

    Lista de archivos abiertos actualmente.

  • openedFilesLimit

    número

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

  • supportsNotifyTag

    booleano opcional

    Chrome 45 y versiones posteriores

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

  • supervisores

    Mirador

    Chrome 45 y versiones posteriores

    Lista de supervisores.

  • admite escritura

    boolean

    Indica si el sistema de archivos admite operaciones que pueden modificar el contenido del sistema de archivos (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

    cadena

    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

    Pendiente

    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

    cadena

    Es la ruta de acceso de la entrada sobre la que se deben recuperar los metadatos.

  • fileSystemId

    cadena

    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.

  • name

    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

    cadena

    Es un nombre legible para el sistema de archivos.

  • fileSystemId

    cadena

    Es el identificador de cadena del sistema de archivos. Debe ser único en 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 0, no está limitado.

  • persistentes

    booleano opcional

    Chrome 64 y versiones posteriores

    Si el framework debe reanudar el sistema de archivos en la siguiente sesión de acceso Es verdadero de forma predeterminada.

  • supportsNotifyTag

    booleano opcional

    Chrome 45 y versiones posteriores

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

  • admite escritura

    booleano opcional

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

MoveEntryRequestedOptions

Propiedades

  • fileSystemId

    cadena

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

  • requestId

    número

    Es el identificador único de esta solicitud.

  • sourcePath

    cadena

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

  • targetPath

    cadena

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

NotifyOptions

Propiedades

  • changeType

    ChangeType

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

  • Cambios

    Cambiar[] opcional

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

  • fileSystemId

    cadena

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

  • observedPath

    cadena

    Es la ruta de la entrada observada.

  • Recurrente

    boolean

    Modo de la entrada observada.

  • etiqueta

    cadena 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 se modificaron incluso cuando el sistema estaba apagado.

OpenedFile

Propiedades

  • filePath

    cadena

    Es la ruta de acceso del archivo abierto.

  • Standard

    OpenFileMode

    Indica si el archivo se abrió para lectura o escritura.

  • openRequestId

    número

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

OpenFileMode

Modo de abrir un archivo. Lo usa onOpenFileRequested.

Enum

OpenFileRequestedOptions

Propiedades

  • filePath

    cadena

    La ruta de acceso del archivo que se abrirá.

  • fileSystemId

    cadena

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

  • Standard

    OpenFileMode

    Indica si el archivo se usará para leer o escribir.

  • requestId

    número

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

ProviderError

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

Enum

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_SPACE"

"INVALID_OPERATION"

"NOT_A_FILE"

"INVALID_URL"

ReadDirectoryRequestedOptions

Propiedades

  • directoryPath

    cadena

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

  • fileSystemId

    cadena

    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.

  • name

    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

    cadena

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

  • length

    número

    Cantidad de bytes que se mostrarán.

  • offset

    número

    Es la posición en el archivo (en bytes) desde la que se comienza 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

    cadena

    Es la ruta de acceso de la entrada supervisada.

  • fileSystemId

    cadena

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

  • Recurrente

    boolean

    Modo del supervisor

  • requestId

    número

    Es el identificador único de esta solicitud.

TruncateRequestedOptions

Propiedades

  • filePath

    cadena

    La ruta del archivo que se truncará.

  • fileSystemId

    cadena

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

  • length

    número

    Cantidad de bytes que se retendrán después de que finalice la operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

UnmountOptions

Propiedades

  • fileSystemId

    cadena

    El identificador del sistema de archivos que se desactivará.

UnmountRequestedOptions

Propiedades

  • fileSystemId

    cadena

    El identificador del sistema de archivos que se desactivará.

  • requestId

    número

    Es el identificador único de esta solicitud.

Watcher

Propiedades

  • entryPath

    cadena

    Es la ruta de la entrada que se observa.

  • lastTag

    cadena opcional

    Es la etiqueta usada por la última notificación del observador.

  • Recurrente

    boolean

    Si la observación debe incluir todas las entradas secundarias de manera recursiva. Puede ser así solo para los directorios.

WriteFileRequestedOptions

Propiedades

  • datos

    ArrayBuffer

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

  • fileSystemId

    cadena

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

  • offset

    número

    Es la posición en el archivo (en bytes) desde la que se comienza 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

    cadena

  • callback

    Función opcional

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

    (fileSystem: FileSystemInfo)=>void

Devuelve

  • Promise<FileSystemInfo>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución 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

Devuelve

  • Promise<FileSystemInfo[]>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

mount()

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

Activa un sistema de archivos con los valores fileSystemId y displayName especificados. Se mostrará displayName en el panel izquierdo de la app de Archivos. displayName puede contener cualquier carácter, como "/", pero no puede ser una cadena vacía. displayName debe ser descriptivo, pero no es necesario que sea único. 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 establecerá runtime.lastError con el código de error correspondiente.

Parámetros

  • Opciones

    MountOptions

  • callback

    Función opcional

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

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

notify()

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

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

Para usarla, la opción file_system_provider.notify del manifiesto debe estar configurada como verdadera.

El valor de tag puede ser cualquier cadena único por llamada, de modo que se pueda identificar la última notificación registrada. Por ejemplo, si la extensión proporcionada comienza después de un reinicio y la etiqueta de la última notificación registrada es igual a "123", debería llamar a notify para todos los cambios que se hayan realizado 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, p. ej., un número de cambio o de revisión.

Ten en cuenta que si se quita un directorio superior, también se quitan todas las entradas subordinadas y, si se observan, se debe notificar a la API sobre el hecho. Además, si se le cambia el nombre a un directorio, se quitarán todas las entradas subordinadas, dado que ya no hay entradas en sus rutas de acceso originales.

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

Parámetros

  • Opciones

    NotifyOptions

  • callback

    Función opcional

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

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

unmount()

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

Desactiva un sistema de archivos con el fileSystemId especificado. Se debe llamar después de que se invoque onUnmountRequested. Además, la extensión proveedora puede decidir realizar la desactivación si no se solicita (por ejemplo, en caso de pérdida de conexión o error de archivo).

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

Parámetros

  • Opciones

    UnmountOptions

  • callback

    Función opcional

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

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onAbortRequested

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

Se genera cuando se solicita anular una operación con operationRequestId. La operación ejecutada con operationRequestId debe detenerse de inmediato y ejecutarse el successCallback de esta solicitud de anulación. Si falla la anulación, 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

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 directorios. Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 solicita cerrar un archivo que se había abierto con openRequestId.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 manifiesto file_system_provider.configurable debe establecerse como verdadera.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 forma recurrente si se solicita un directorio). Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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

    la 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, se debe llamar a errorCallback con el código de error "EXISTS".

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 borrar una entrada. Si recursive es "true", y la entrada es un directorio, todas las entradas incluidas en ella también se deben borrar de forma recursiva.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 la ejecución de una acción para un conjunto de archivos o directorios. Una vez completada la acción, se debe llamar a successCallback. Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    la 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 que se muestran deben ser aplicables a cada entrada. Si no hay tales acciones, se debe mostrar un array vacío. Las acciones deben mostrarse con la llamada successCallback. En caso de error, se debe llamar a errorCallback.

Parámetros

  • callback

    la 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 los metadatos de un archivo o un directorio en entryPath. Los metadatos deben mostrarse 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 solicita un diálogo para activar un sistema de archivos nuevo. Si la extensión o la app es un controlador de archivos, no se debe controlar este evento. 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 file_system_provider.multiple_mounts del manifiesto debe configurarse como verdadera.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 solicita mover una entrada (de forma recurrente si se solicita un directorio). Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 solicita abrir un archivo en filePath. Si el archivo no existe, la operación debe fallar. Con MountOptions, se puede especificar la cantidad máxima de archivos abiertos a la vez.

Parámetros

onReadDirectoryRequested

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

Se genera cuando se solicita el contenido de un directorio en directoryPath. Los resultados deben mostrarse 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 que se abrió antes con openRequestId. Los resultados deben mostrarse en fragmentos llamando a successCallback varias veces. En caso de error, se debe llamar a errorCallback.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

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

      • datos

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      la 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

    la 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 trunca un archivo en la longitud deseada. Si se produce un error, se debe llamar a errorCallback.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 solicita la desactivación del 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 desmontarlo (p. ej., debido a una operación pendiente), se debe llamar a errorCallback.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la 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 contenido en un archivo que se abrió antes con openRequestId.

Parámetros

  • callback

    la función

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

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

    • successCallback

      la función

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

      ()=>void

    • errorCallback

      la función

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

      (error: ProviderError)=>void