chrome.fileSystemProvider

Descripción

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

Permisos

fileSystemProvider

Disponibilidad

Solo en 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 debe declararse de la siguiente manera:

configurable (booleano): Opcional
Indica si se admite la configuración a través de onConfigureRequested. El valor predeterminado es false.
multiple_mounts (booleano): Opcional
Indica si se admiten varios sistemas de archivos activados (más de uno). El valor predeterminado es false.
watchable (booleano): Opcional
Indica si se admite la configuración de observadores y la notificación sobre cambios. El valor predeterminado es false.
source (enum de "file", "device" o "network"): Obligatorio
Fuente de datos para los sistemas de archivos activados.

La app de Archivos usa la información anterior para renderizar los elementos de la IU relacionados de forma adecuada. Por ejemplo, si configurable se establece como verdadero, se renderizará un elemento de menú para configurar los volúmenes. Del mismo modo, si multiple_mounts se establece en true, la app de Files 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 observadores para que los cambios en el sistema de archivos se reflejen de inmediato y de forma automática.

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 la descompresión de archivos y el acceso a archivos en un servicio en la nube que no sea Drive.

Activar sistemas de archivos

Las extensiones pueden proporcionar contenido del sistema de archivos desde una fuente externa (como un servidor remoto o un dispositivo USB) o usar 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 estar montado cuando se llame al evento onMountRequested.

Fuente de los datos del sistema de archivos Punto de entrada
"file" Solo está disponible para las apps empaquetadas.
"device" o "network" onMountRequested

Configuración de sistemas de archivos

Los sistemas de archivos proporcionados, una vez activados, se pueden configurar a través del evento onConfigureRequested. Es especialmente útil para los 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 que se montan y los vuelve a montar automáticamente después de reiniciar el dispositivo. Por lo tanto, una vez que una extensión que proporciona un sistema de archivos lo monte, permanecerá así hasta que se descargue la extensión o hasta que esta 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

    Es el 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

    cadena opcional

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

AddWatcherRequestedOptions

Propiedades

  • entryPath

    string

    Es la ruta de la entrada que se observará.

  • fileSystemId

    string

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

  • Recurrente

    booleano

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

  • requestId

    número

    Es el identificador único de esta solicitud.

Change

Propiedades

  • changeType

    ChangeType

    Es el tipo de cambio que se produjo en la entrada.

  • cloudFileInfo

    CloudFileInfo opcional

    Chrome 125 y versiones posteriores

    Es la información relacionada con el archivo si está respaldado por un sistema de archivos en la nube.

  • entryPath

    string

    Es la ruta de acceso a la entrada modificada.

ChangeType

Es el tipo de cambio detectado en el directorio observado.

Enum

"CHANGED"

"DELETED"

CloseFileRequestedOptions

Propiedades

  • fileSystemId

    string

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

  • openRequestId

    número

    Es 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

    cadena opcional

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

CloudIdentifier

Chrome 117 y versiones posteriores

Propiedades

  • id

    string

    Es 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" se usa para compartir archivos con otras personas. "SAVE_FOR_OFFLINE" para fijar (guardar para acceder sin conexión). "OFFLINE_NOT_NECESSARY" para notificar que ya no es necesario almacenar el archivo para el acceso sin conexión. Usado por 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

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

  • targetPath

    string

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

CreateDirectoryRequestedOptions

Propiedades

  • directoryPath

    string

    Es la ruta del directorio que se creará.

  • fileSystemId

    string

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

  • Recurrente

    booleano

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

  • requestId

    número

    Es el identificador único de esta solicitud.

CreateFileRequestedOptions

Propiedades

  • filePath

    string

    Es la ruta 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

    Es 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

    booleano

    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

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

  • cloudIdentifier

    CloudIdentifier opcional

    Chrome 117 y versiones posteriores

    Representación de almacenamiento en la nube de esta entrada. Se debe proporcionar si se solicita en options y el archivo está respaldado por almacenamiento en la nube. En el caso de los archivos locales que no tienen respaldo en el almacenamiento en la nube, debe ser indefinido cuando se solicite.

  • isDirectory

    booleano opcional

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

  • mimeType

    cadena opcional

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

  • modificationTime

    Fecha opcional

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

  • nombre

    cadena opcional

    Nombre de esta entrada (no es el nombre de la ruta de acceso completa). 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

    cadena opcional

    Imagen en miniatura como URI de datos en formato PNG, JPEG o WEBP, con un tamaño máximo de 32 KB. Es opcional, pero solo se puede proporcionar cuando el evento onGetMetadataRequested lo solicita de forma 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

    Es el conjunto de rutas 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

    OpenedFile[]

    Lista de los archivos abiertos actualmente.

  • openedFilesLimit

    número

    Es la cantidad máxima de archivos que se pueden abrir al mismo tiempo. Si es 0, no hay límite.

  • supportsNotifyTag

    booleano opcional

    Chrome 45 y versiones posteriores

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

  • Observadores

    Watcher[]

    Chrome 45 y versiones posteriores

    Lista de observadores.

  • admite escritura

    booleano

    Indica si el sistema de archivos admite operaciones que pueden cambiar 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

    Es la lista de rutas de acceso de las 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

    booleano

    Chrome 125 y versiones posteriores

    Se establece en true si se solicita el valor de cloudFileInfo.

  • cloudIdentifier

    booleano

    Chrome 117 y versiones posteriores

    Se establece en true si se solicita el valor de cloudIdentifier.

  • entryPath

    string

    Es la ruta 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

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de is_directory.

  • mimeType

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de mimeType.

  • modificationTime

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de modificationTime.

  • nombre

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de name.

  • requestId

    número

    Es el identificador único de esta solicitud.

  • tamaño

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de size.

  • miniatura

    booleano

    Se establece en true si se solicita el valor de thumbnail.

MountOptions

Propiedades

  • displayName

    string

    Es un nombre legible para el sistema de archivos.

  • fileSystemId

    string

    Es el identificador de cadena del sistema de archivos. Debe ser único para cada extensión.

  • openedFilesLimit

    número opcional

    Es la cantidad máxima de archivos que se pueden abrir al mismo tiempo. Si no se especifica o es 0, no hay límite.

  • 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. El valor predeterminado es verdadero.

  • 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

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

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

  • targetPath

    string

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

NotifyOptions

Propiedades

  • changeType

    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

    Change[] opcional

    Lista de cambios en las entradas 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 acceso de la entrada observada.

  • Recurrente

    booleano

    Es el modo de la entrada observada.

  • etiqueta

    cadena opcional

    Es la etiqueta de la notificación. Se requiere 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 produjeron incluso cuando el sistema estaba apagado.

OpenedFile

Propiedades

  • filePath

    string

    Ruta del archivo abierto.

  • Standard

    OpenFileMode

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

  • openRequestId

    número

    Es un ID de solicitud que se usará en solicitudes consecutivas de lectura/escritura y cierre.

OpenFileMode

Modo de apertura de un archivo. Lo usa onOpenFileRequested.

Enum

"READ"

"WRITE"

OpenFileRequestedOptions

Propiedades

  • filePath

    string

    Es la ruta del archivo que se abrirá.

  • fileSystemId

    string

    Es 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

    Es un ID de solicitud que se usará en solicitudes consecutivas de lectura/escritura y cierre.

ProviderError

Son los códigos de error que usan las extensiones de entrega en respuesta a las solicitudes, así como en caso de errores cuando se llaman a métodos de la API. Para que sea correcta, se debe usar "OK".

Enum

"Aceptar"

"FAILED"

"IN_USE"

"EXISTS"

"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

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de is_directory.

  • mimeType

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de mimeType.

  • modificationTime

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de modificationTime.

  • nombre

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de name.

  • requestId

    número

    Es el identificador único de esta solicitud.

  • tamaño

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de size.

  • miniatura

    booleano

    Chrome 49 y versiones posteriores

    Se establece en true si se solicita el valor de 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 devolverán.

  • offset

    número

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

  • openRequestId

    número

    Es 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 a la entrada observada.

  • fileSystemId

    string

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

  • Recurrente

    booleano

    Es el modo del observador.

  • requestId

    número

    Es el identificador único de esta solicitud.

TruncateRequestedOptions

Propiedades

  • filePath

    string

    Es 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 después de que se complete la operación.

  • requestId

    número

    Es el identificador único de esta solicitud.

UnmountOptions

Propiedades

  • fileSystemId

    string

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

UnmountRequestedOptions

Propiedades

  • fileSystemId

    string

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

  • requestId

    número

    Es el identificador único de esta solicitud.

Watcher

Propiedades

  • entryPath

    string

    Es la ruta de acceso de la entrada que se observa.

  • lastTag

    cadena opcional

    Es la etiqueta que usó la última notificación para el observador.

  • Recurrente

    booleano

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

WriteFileRequestedOptions

Propiedades

  • datos

    ArrayBuffer

    Es 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 comenzará a escribir los bytes.

  • openRequestId

    número

    Es un ID de solicitud que se usa para abrir el archivo.

  • requestId

    número

    Es el identificador único de esta solicitud.

Métodos

get()

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

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

Parámetros

  • fileSystemId

    string

Muestra

getAll()

chrome.fileSystemProvider.getAll(): Promise<FileSystemInfo[]>

Devuelve todos los sistemas de archivos que montó la extensión.

Muestra

mount()

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

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. displayName debe ser descriptivo, pero no tiene que ser único. fileSystemId no debe ser una cadena vacía.

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

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

Parámetros

Muestra

  • Promise<void>

    Chrome 96 y versiones posteriores

notify()

Chrome 45 y versiones posteriores 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
): Promise<void>

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

Para usarla, la opción de manifiesto file_system_provider.notify debe establecerse 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. Por ejemplo, si la extensión que proporciona el servicio se inicia después de un reinicio y la etiqueta de la última notificación registrada es igual a "123", debe llamar a notify para todos los cambios que se produjeron 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 quitarán todas las entradas secundarias y, si se supervisan, se debe notificar a la API sobre este hecho. Además, si se cambia el nombre de un directorio, se quitan todas las entradas descendientes, ya que no hay ninguna entrada en sus rutas originales.

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

Parámetros

Muestra

  • Promise<void>

    Chrome 96 y versiones posteriores

unmount()

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

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

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

Parámetros

Muestra

  • Promise<void>

    Chrome 96 y versiones posteriores

Eventos

onAbortRequested

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

Se genera cuando se solicita la anulación de una operación con operationRequestId. La operación ejecutada con operationRequestId debe detenerse de inmediato y debe ejecutarse 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, es posible que la solicitud se anule de forma forzada.

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 configurar un nuevo observador de directorios. 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 solicita el cierre de un archivo que se abrió previamente con openRequestId.

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 mostrar un diálogo de configuración para fileSystemId. Si se controla, la opción del manifiesto file_system_provider.configurable debe establecerse como verdadera.

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 solicita copiar una entrada (de forma recursiva si es 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 faltantes en la ruta de acceso 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, se debe 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 borrar una entrada. Si recursive es verdadero y la entrada es un directorio, también se deben borrar de forma recursiva todas las entradas que contiene.

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 la ejecución de una acción para un conjunto de archivos o directorios. Una vez que se complete 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 devueltas deben ser aplicables a cada entrada. Si no hay acciones de este tipo, se debe devolver un array vacío. Las acciones se deben devolver 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 los metadatos de un archivo o un directorio en entryPath. Los metadatos se deben devolver con la llamada a 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 mostrar un diálogo para montar un nuevo sistema de archivos. 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 nuevos sistemas de archivos 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 solicita mover una entrada (de forma recursiva si es 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 solicita abrir un archivo en filePath. Si el archivo no existe, la operación debe fallar. La cantidad máxima de archivos que se pueden abrir a la vez se puede especificar con 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 devolver 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ó anteriormente con openRequestId. Los resultados se deben devolver 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

        booleano

    • 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 observador. 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 truncar un archivo a una 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 solicita el desmontaje del sistema de archivos con el identificador fileSystemId. En la respuesta, el método de la API unmount se debe llamar junto con successCallback. Si no es posible desmontar (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 solicita escribir contenido en un archivo que se abrió previamente 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