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
Manifest
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
Propiedades
-
id
cadena
El identificador de la acción. Cualquier cadena o
CommonActionId
para acciones comunes. -
title
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
El tipo de cambio que se realizó en la entrada.
-
cloudFileInfo
CloudFileInfo opcional
Chrome 125 y versiones posterioresInformació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
Propiedades
-
versionTag
cadena opcional
Una etiqueta que representa la versión del archivo.
CloudIdentifier
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
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
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
Chrome 125 y versiones posterioresInformació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 posterioresRepresentació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
Propiedades
-
actionId
cadena
El identificador de la acción que se ejecutará.
-
entryPaths
string[]
Chrome 47 y versiones posterioresEl 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
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 posterioresIndica si el sistema de archivos admite el campo
tag
para observar directorios. -
supervisoresChrome 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
Propiedades
-
entryPaths
string[]
Chrome 47 y versiones posterioresLista 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
Chrome 125 y versiones posterioresSe establece en
true
si se solicita el valorcloudFileInfo
. -
cloudIdentifier
boolean
Chrome 117 y versiones posterioresSe establece en
true
si se solicita el valorcloudIdentifier
. -
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 posterioresSe establece en
true
si se solicita el valoris_directory
. -
mimeType
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valormimeType
. -
modificationTime
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valormodificationTime
. -
name
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valorname
. -
requestId
número
Es el identificador único de esta solicitud.
-
tamaño
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valorsize
. -
miniatura
boolean
Se establece en
true
si se solicita el valorthumbnail
.
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 posterioresSi 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 posterioresSi 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
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
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
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 posterioresSe establece en
true
si se solicita el valoris_directory
. -
mimeType
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valormimeType
. -
modificationTime
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valormodificationTime
. -
name
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valorname
. -
requestId
número
Es el identificador único de esta solicitud.
-
tamaño
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valorsize
. -
miniatura
boolean
Chrome 49 y versiones posterioresSe establece en
true
si se solicita el valorthumbnail
.
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()
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
-
fileSystem
-
Devuelve
-
Promise<FileSystemInfo>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getAll()
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
-
fileSystems
-
Devuelve
-
Promise<FileSystemInfo[]>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
mount()
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
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Devuelve
-
Promise<void>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
notify()
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
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Devuelve
-
Promise<void>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
unmount()
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
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Devuelve
-
Promise<void>
Chrome 96 y versiones posterioresLas 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 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
-
Opciones
-
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
-
error
-
-
onAddWatcherRequested
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
onConfigureRequested
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
onExecuteActionRequested
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
-
Opciones
-
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
-
error
-
-
onGetActionsRequested
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
-
Opciones
-
successCallback
la función
El parámetro
successCallback
se ve de la siguiente manera:(actions: Action[]) => void
-
de solución
-
-
errorCallback
la función
El parámetro
errorCallback
se ve de la siguiente manera:(error: ProviderError) => void
-
error
-
-
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
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
-
Opciones
-
successCallback
la función
El parámetro
successCallback
se ve de la siguiente manera:(metadata: EntryMetadata) => void
-
metadatos
-
-
errorCallback
la función
El parámetro
errorCallback
se ve de la siguiente manera:(error: ProviderError) => void
-
error
-
-
onMountRequested
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
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
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
Opciones
-
successCallback
la función
El parámetro
successCallback
se ve de la siguiente manera:(metadata?: EntryMetadata) => void
-
metadatos
EntryMetadata opcional
-
-
errorCallback
la función
El parámetro
errorCallback
se ve de la siguiente manera:(error: ProviderError) => void
-
error
-
-
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
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
Opciones
-
successCallback
la función
El parámetro
successCallback
se ve de la siguiente manera:(entries: EntryMetadata[], hasMore: boolean) => void
-
entradas
-
hasMore
boolean
-
-
errorCallback
la función
El parámetro
errorCallback
se ve de la siguiente manera:(error: ProviderError) => void
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
onRemoveWatcherRequested
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-
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
-
Opciones
-
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
-
error
-
-