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
Manifiesto
Debes declarar el "fileSystemProvider" permiso y sección del manifiesto de extensión para usar la API de File System Provider Por ejemplo:
{
"name": "My extension",
...
"permissions": [
"fileSystemProvider"
],
...
"file_system_provider_capabilities": {
"configurable": true,
"watchable": false,
"multiple_mounts": true,
"source": "network"
},
...
}
La sección file_system_provider se debe declarar de la siguiente manera:
configurable
(booleano): opcional- Si se admite la configuración mediante onConfigureRequested De forma predeterminada, el valor es falso.
multiple_mounts
(booleano): opcional- Indica si se admiten varios (más de uno) sistemas de archivos activados. De forma predeterminada, el valor es falso.
watchable
(booleano): opcional- Indica si se admite la configuración de supervisores y la notificación sobre los cambios. De forma predeterminada, el valor es falso.
source
(enum. de "file", "device" o "network"): obligatorio- Fuente de datos para sistemas de archivos activados.
La app de Files usa la información anterior para renderizar los elementos relacionados de la IU de manera adecuada. Por ejemplo, si se establece configurable
como verdadero, se renderizará un elemento de menú para configurar volúmenes. De manera similar, si estableces multiple_mounts
como true
, la app de Archivos permitirá agregar más de un punto de activación desde la IU. Si watchable
es false
, se renderizará un botón de actualización. Ten en cuenta que, si es posible, debes agregar compatibilidad para observadores, de modo que los cambios en el sistema de archivos se puedan reflejar de inmediato y automáticamente.
Descripción general
La API de File System Provider permite que las extensiones sean compatibles con los sistemas de archivos virtuales, que están disponibles en el administrador de archivos de ChromeOS. Los casos de uso incluyen la descompresión de archivos y el acceso a ellos en un servicio en la nube que no sea Drive.
Activar sistemas de archivos
Las extensiones que se proporcionan pueden incluir contenido del sistema de archivos desde una fuente externa (como un servidor remoto o un dispositivo USB) o utilizar un archivo local (como un archivo) como entrada.
Para escribir sistemas de archivos que sean controladores de archivos (el origen es "file"
), el proveedor debe ser una app empaquetada, ya que el evento onLaunched
no está disponible para las extensiones.
Si la fuente es una red o un dispositivo, el sistema de archivos debería activarse cuando se llame al evento onMountRequested.
La fuente de los datos del sistema de archivos | Punto de entrada |
---|---|
"file" |
Disponible solo para aplicaciones empaquetadas. |
"device" o "network" |
onMountRequested |
Configurar sistemas de archivos
Los sistemas de archivos proporcionados una vez activados se pueden configurar a través del evento onConfigureRequested. Es especialmente útil para sistemas de archivos que proporcionan contenido a través de la red para establecer las credenciales adecuadas. El control de este evento es opcional.
Ciclo de vida
Chrome recuerda los sistemas de archivos proporcionados una vez activados y se vuelven a activar automáticamente después de reiniciarlos o reiniciarlos. Por lo tanto, una vez que una extensión proporcional activa un sistema de archivos, este permanecerá hasta que se descargue la extensión o hasta que llame al método unmount.
Tipos
AbortRequestedOptions
Propiedades
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
operationRequestId
número
Un ID de la solicitud que se anulará.
-
requestId
número
Es el identificador único de esta solicitud.
Action
Propiedades
-
id
string
Es el identificador de la acción. Cualquier cadena o
CommonActionId
para acciones comunes -
título
string opcional
Es el título de la acción. Es posible que se ignore para acciones comunes.
AddWatcherRequestedOptions
Propiedades
-
entryPath
string
Es la ruta de la entrada que se debe observar.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
Recurrente
boolean
Si la observación debe incluir todas las entradas secundarias de forma recursiva. Solo puede ser verdadera para los directorios.
-
requestId
número
Es el identificador único de esta solicitud.
Change
Propiedades
-
changeType
El tipo de cambio que se produjo en la entrada.
-
cloudFileInfo
CloudFileInfo opcional
Chrome 125 y versiones posterioresInformación relacionada con el archivo si está respaldada por un sistema de archivos en la nube.
-
entryPath
string
La ruta de la entrada modificada.
ChangeType
Tipo de cambio detectado en el directorio observado.
Enum
“CAMBIADO”
"BORRADO"
CloseFileRequestedOptions
Propiedades
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
openRequestId
número
Un ID de solicitud que se usa para abrir el archivo.
-
requestId
número
Es el identificador único de esta solicitud.
CloudFileInfo
Propiedades
-
versionTag
string opcional
Es una etiqueta que representa la versión del archivo.
CloudIdentifier
Propiedades
-
id
string
El identificador del proveedor para el archivo o directorio determinado.
-
providerName
string
Es el identificador del proveedor de almacenamiento en la nube (p.ej., “drive.google.com”).
CommonActionId
Lista de acciones comunes. "SHARE"
es para compartir archivos con otros usuarios. "SAVE_FOR_OFFLINE"
para fijar (se guarda para el acceso sin conexión) "OFFLINE_NOT_NECESSARY"
para notificar que ya no es necesario almacenar el archivo para el acceso sin conexión. Lo usan onGetActionsRequested
y onExecuteActionRequested
.
Enum
“SAVE_FOR_OFFLINE”
"OFFLINE_NOT_NECESSARY"
“COMPARTIR”
ConfigureRequestedOptions
Propiedades
-
fileSystemId
string
Es el identificador del sistema de archivos que se configurará.
-
requestId
número
Es el identificador único de esta solicitud.
CopyEntryRequestedOptions
Propiedades
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
requestId
número
Es el identificador único de esta solicitud.
-
sourcePath
string
La ruta de acceso de origen de la entrada que se copiará.
-
targetPath
string
La ruta de destino para la operación de copia.
CreateDirectoryRequestedOptions
Propiedades
-
directoryPath
string
La ruta de acceso del directorio que se creará.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
Recurrente
boolean
Indica si la operación es recursiva (solo para directorios).
-
requestId
número
Es el identificador único de esta solicitud.
CreateFileRequestedOptions
Propiedades
-
filePath
string
La ruta de acceso del archivo que se creará.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
requestId
número
Es el identificador único de esta solicitud.
DeleteEntryRequestedOptions
Propiedades
-
entryPath
string
La ruta de acceso de la entrada que se borrará.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
Recurrente
boolean
Indica si la operación es recursiva (solo para directorios).
-
requestId
número
Es el identificador único de esta solicitud.
EntryMetadata
Propiedades
-
cloudFileInfo
CloudFileInfo opcional
Chrome 125 y versiones posterioresInformación que identifica un archivo específico en el sistema subyacente de archivos en la nube. Se debe proporcionar si se solicita en
options
y el archivo está respaldado por el almacenamiento en la nube. -
cloudIdentifier
CloudIdentifier opcional
Chrome 117 y versiones posterioresRepresentación de esta entrada en Cloud Storage. Se debe proporcionar si se solicita en
options
y el archivo está respaldado por el almacenamiento en la nube. En el caso de los archivos locales que no estén respaldados por el almacenamiento en la nube, no deberían estar definidos cuando se soliciten. -
isDirectory
booleano opcional
Verdadero si se trata de un directorio. Se debe proporcionar si se solicita en
options
. -
mimeType
string opcional
Tipo MIME de la entrada. Siempre es opcional, pero se debe proporcionar si se solicita en
options
. -
modificationTime
Fecha opcional
La hora de la última modificación de esta entrada. Se debe proporcionar si se solicita en
options
. -
nombre
string opcional
Es el nombre de esta entrada (no el nombre completo de la ruta de acceso). No debe contener “/”. Para la raíz, debe estar vacío. Se debe proporcionar si se solicita en
options
. -
tamaño
número opcional
Tamaño del archivo en bytes. Se debe proporcionar si se solicita en
options
. -
miniatura
string opcional
Imagen en miniatura como un URI de datos en formato PNG, JPEG o WEBP, con un tamaño máximo de 32 KB. Opcional, pero se puede proporcionar solo cuando el evento
onGetMetadataRequested
lo solicita de manera explícita.
ExecuteActionRequestedOptions
Propiedades
-
actionId
string
Es 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
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
requestId
número
Es el identificador único de esta solicitud.
FileSystemInfo
Propiedades
-
displayName
string
Es un nombre legible para el sistema de archivos.
-
fileSystemId
string
Es el identificador del sistema de archivos.
-
openedFiles
Lista de archivos abiertos actualmente.
-
openedFilesLimit
número
La cantidad máxima de archivos que se pueden abrir a la vez. Si es 0, entonces no se limita.
-
supportsNotifyTag
booleano opcional
Chrome 45 y versiones posterioresIndica si el sistema de archivos admite el campo
tag
para observar directorios. -
observadoresChrome 45 y versiones posteriores
Lista de supervisores.
-
admite escritura
boolean
Si el sistema de archivos admite operaciones que pueden cambiar el contenido del sistema (como crear, borrar o escribir en archivos).
GetActionsRequestedOptions
Propiedades
-
entryPaths
string[]
Chrome 47 y versiones posterioresLista de rutas de acceso de entradas para la lista de acciones.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
requestId
número
Es el identificador único de esta solicitud.
GetMetadataRequestedOptions
Propiedades
-
cloudFileInfo
boolean
Chrome 125 y versiones 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
string
La ruta de acceso de la entrada sobre la que se recuperarán los metadatos.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
isDirectory
boolean
Chrome 49 y versiones 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
. -
nombre
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
string
Es un nombre legible para el sistema de archivos.
-
fileSystemId
string
El identificador de cadenas del sistema de archivos. Debe ser único para cada extensión.
-
openedFilesLimit
número opcional
La cantidad máxima de archivos que se pueden abrir a la vez. Si no se especifica, o es 0, entonces no se limita.
-
persistentes
booleano opcional
Chrome 64 y versiones posterioresIndica si el framework debe reanudar el sistema de archivos en la próxima sesión de acceso. Verdadero de forma predeterminada.
-
supportsNotifyTag
booleano opcional
Chrome 45 y versiones posterioresIndica si el sistema de archivos admite el campo
tag
para los directorios observados. -
admite escritura
booleano opcional
Si el sistema de archivos admite operaciones que pueden cambiar el contenido del sistema (como crear, borrar o escribir en archivos).
MoveEntryRequestedOptions
Propiedades
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
requestId
número
Es el identificador único de esta solicitud.
-
sourcePath
string
La ruta de acceso de origen de la entrada que se moverá a un lugar nuevo.
-
targetPath
string
La ruta de destino para la operación de copia.
NotifyOptions
Propiedades
-
changeType
Es el tipo de cambio que se produjo en la entrada observada. Si es DELETED, la entrada observada se quitará automáticamente de la lista de entradas observadas.
-
Cambios
Cambio[] opcional
Lista de cambios en las entradas dentro del directorio observado (incluida la entrada en sí)
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con este cambio.
-
observedPath
string
Es la ruta de la entrada observada.
-
Recurrente
boolean
Modo de la entrada observada.
-
etiqueta
string opcional
Etiqueta de la notificación. Es obligatorio si el sistema de archivos se activó con la opción
supportsNotifyTag
. Ten en cuenta que esta marca es necesaria para proporcionar notificaciones sobre los cambios que cambiaron incluso cuando se apagó el sistema.
OpenedFile
Propiedades
-
filePath
string
Es la ruta de acceso del archivo abierto.
-
Standard
Si el archivo se abrió para lectura o escritura
-
openRequestId
número
Un ID de solicitud que usarán las solicitudes consecutivas de lectura y escritura y de cierre.
OpenFileMode
Modo de abrir un archivo. Lo usa onOpenFileRequested
.
Enum
“LEER”
“ESCRITURA”
OpenFileRequestedOptions
Propiedades
-
filePath
string
La ruta del archivo que se abrirá.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
Standard
Si el archivo se usará para lectura o escritura.
-
requestId
número
Un ID de solicitud que usarán las solicitudes consecutivas de lectura y escritura y de cierre.
ProviderError
Códigos de error que se usan al proporcionar extensiones en respuesta a solicitudes y en caso de errores cuando se llama a los métodos de la API. Para que se realice correctamente, se debe usar "OK"
.
Enum
“Aceptar”
"ERROR"
“IN_USE”
"EXISTE"
"NOT_FOUND"
"ACCESS_DENIED"
“TOO_MANY_OPENED”
"NO_MEMORY"
"NO_SPACE"
"NOT_A_DIRECTORY"
“INVALID_OPERATION”
"SEGURIDAD"
“ABORT”
"NOT_A_FILE"
"NOT_EMPTY"
"INVALID_URL"
"IO"
ReadDirectoryRequestedOptions
Propiedades
-
directoryPath
string
Es la ruta de acceso del directorio cuyo contenido se solicita.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
isDirectory
boolean
Chrome 49 y versiones 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
. -
nombre
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
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
longitud
número
Cantidad de bytes que se mostrarán.
-
offset
número
Posición en el archivo (en bytes) desde la que se empieza a leer.
-
openRequestId
número
Un ID de solicitud que se usa para abrir el archivo.
-
requestId
número
Es el identificador único de esta solicitud.
RemoveWatcherRequestedOptions
Propiedades
-
entryPath
string
Es la ruta de acceso de la entrada visualizada.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
Recurrente
boolean
Modo del observador.
-
requestId
número
Es el identificador único de esta solicitud.
TruncateRequestedOptions
Propiedades
-
filePath
string
La ruta del archivo que se truncará.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
longitud
número
Cantidad de bytes que se retendrán una vez finalizada la operación.
-
requestId
número
Es el identificador único de esta solicitud.
UnmountOptions
Propiedades
-
fileSystemId
string
El identificador del sistema de archivos que se desactivará.
UnmountRequestedOptions
Propiedades
-
fileSystemId
string
El identificador del sistema de archivos que se desactivará.
-
requestId
número
Es el identificador único de esta solicitud.
Watcher
Propiedades
-
entryPath
string
La ruta de la entrada que se observa.
-
lastTag
string opcional
Etiqueta que usó la última notificación para el supervisor.
-
Recurrente
boolean
Si la visualización debe incluir todas las entradas secundarias de forma recurrente. Solo puede ser verdadera para los directorios.
WriteFileRequestedOptions
Propiedades
-
datos
ArrayBuffer
El búfer de bytes que se escribirán en el archivo.
-
fileSystemId
string
Es el identificador del sistema de archivos relacionado con esta operación.
-
offset
número
Posición en el archivo (en bytes) desde la que se comienzan a escribir los bytes.
-
openRequestId
número
Un ID de solicitud que se usa para abrir el archivo.
-
requestId
número
Es el identificador único de esta solicitud.
Métodos
get()
chrome.fileSystemProvider.get(
fileSystemId: string,
callback?: function,
)
Muestra información sobre un sistema de archivos con el fileSystemId
pasado.
Parámetros
-
fileSystemId
string
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(fileSystem: FileSystemInfo) => void
-
fileSystem
-
Muestra
-
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
-
Muestra
-
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 fileSystemId
y displayName
especificados. displayName
se mostrará en el panel izquierdo de la app de Archivos. displayName
puede contener cualquier carácter, incluido “/”, pero no puede ser una cadena vacía. El campo displayName
debe ser descriptivo, pero no es necesario que sea único. El fileSystemId
no debe ser una cadena vacía.
Según el tipo de sistema de archivos que se active, la opción source
debe configurarse de forma correcta.
En caso de error, se configurará runtime.lastError
con el código de error correspondiente.
Parámetros
-
opciones
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promesa<void>
Chrome 96 y versiones 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 los cambios en el directorio visualizado en observedPath
en el modo recursive
. Si el sistema de archivos está activado con supportsNotifyTag
, se debe proporcionar tag
, y todos los cambios realizados desde la última notificación siempre se informan, incluso si se cerró el sistema. La última etiqueta se puede obtener con getAll
.
Para usarla, se debe establecer la opción del manifiesto file_system_provider.notify
como verdadera.
El valor de tag
puede ser cualquier cadena que sea única por llamada, por lo que es posible identificar la última notificación registrada. P. ej., Si la extensión que proporciona la información comienza después de un reinicio y la última etiqueta de la notificación registrada es igual a "123", debe llamar a notify
para todos los cambios que ocurrieron desde el cambio etiquetado como "123". No puede ser una cadena vacía.
No todos los proveedores pueden proporcionar una etiqueta, pero si el sistema de archivos tiene un registro de cambios, la etiqueta puede ser, por ejemplo, un número de cambio o un número de revisión.
Ten en cuenta que si se quita un directorio principal, también se quitan todas las entradas subordinadas y, si se observan, se debe notificar a la API al respecto. Además, si se cambia el nombre de un directorio, entonces se quitan todas las entradas subordinadas, dado que ya no hay ninguna entrada en sus rutas de acceso originales.
En caso de error, se configurará runtime.lastError
con el código de error correspondiente.
Parámetros
-
opciones
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promesa<void>
Chrome 96 y versiones 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
determinado. Se debe llamar después de invocar onUnmountRequested
. Además, la extensión que proporciona puede decidir desactivarse si no se solicita (p. ej., en caso de pérdida de conexión o de un error de archivo).
En caso de error, se configurará runtime.lastError
con el código de error correspondiente.
Parámetros
-
opciones
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promesa<void>
Chrome 96 y versiones 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 anula una operación con operationRequestId
. La operación que se ejecutó con operationRequestId
se debe detener de inmediato y el successCallback
de esta solicitud de anulación se debe ejecutar. Si la anulación falla, se debe llamar a errorCallback
. Ten en cuenta que no se deben llamar a las devoluciones de llamada de la operación anulada, ya que se ignorarán. A pesar de llamar a errorCallback
, la solicitud se puede anular de manera forzosa.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onAddWatcherRequested
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
callback: function,
)
Se genera cuando se solicita la configuración de un nuevo observador de directorio. Si se produce un error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onCloseFileRequested
chrome.fileSystemProvider.onCloseFileRequested.addListener(
callback: function,
)
Se genera cuando se abre un archivo que se abrió anteriormente con openRequestId
y se solicita que se cierre.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
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 manfiest file_system_provider.configurable
debe configurarse como true.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onCopyEntryRequested
chrome.fileSystemProvider.onCopyEntryRequested.addListener(
callback: function,
)
Se genera cuando se copia una entrada (de manera recurrente si se solicita un directorio). Si se produce un error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
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
función
El parámetro
callback
se ve de la siguiente manera:(options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onCreateFileRequested
chrome.fileSystemProvider.onCreateFileRequested.addListener(
callback: function,
)
Se genera cuando se solicita la creación de un archivo. Si el archivo ya existe, debes llamar a errorCallback
con el código de error "EXISTS"
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onDeleteEntryRequested
chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
callback: function,
)
Se genera cuando se solicita la eliminación de una entrada. Si recursive
es verdadero y la entrada es un directorio, todas las entradas dentro deben borrarse de manera recurrente.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onExecuteActionRequested
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
callback: function,
)
Se genera cuando se solicita una acción para un conjunto de archivos o directorios. Una vez completada la acción, se debe llamar a successCallback
. En caso de error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: ExecuteActionRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
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 mostradas deben ser aplicables a cada entrada. Si no existen tales acciones, se debe mostrar un array vacío. Las acciones se deben mostrar con la llamada a successCallback
. En caso de error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
successCallback
función
El parámetro
successCallback
se ve de la siguiente manera:(actions: Action[]) => void
-
de solución
-
-
errorCallback
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 metadatos de un archivo o un directorio en entryPath
. Los metadatos se deben mostrar con la llamada successCallback
. En caso de error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
successCallback
función
El parámetro
successCallback
se ve de la siguiente manera:(metadata: EntryMetadata) => void
-
metadatos
-
-
errorCallback
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 muestra un diálogo para activar un nuevo sistema de archivos. Si la extensión o la aplicación es un controlador de archivos, este evento no debería controlarse. En su lugar, se debe controlar app.runtime.onLaunched
para activar sistemas de archivos nuevos cuando se abre un archivo. Para varias activaciones, la opción del manifiesto file_system_provider.multiple_mounts
debe establecerse como verdadera.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(successCallback: function, errorCallback: function) => void
-
successCallback
función
El parámetro
successCallback
se ve de la siguiente manera:() => void
-
errorCallback
función
El parámetro
errorCallback
se ve de la siguiente manera:(error: ProviderError) => void
-
error
-
-
onMoveEntryRequested
chrome.fileSystemProvider.onMoveEntryRequested.addListener(
callback: function,
)
Se genera cuando se mueve una entrada (de manera recurrente si se solicita un directorio). Si se produce un error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onOpenFileRequested
chrome.fileSystemProvider.onOpenFileRequested.addListener(
callback: function,
)
Se genera cuando se abre un archivo en filePath
. Si el archivo no existe, la operación debe fallar. Para especificar la cantidad máxima de archivos que se pueden abrir a la vez, usa MountOptions
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
successCallback
función
El parámetro
successCallback
se ve de la siguiente manera:(metadata?: EntryMetadata) => void
-
metadatos
EntryMetadata opcional
-
-
errorCallback
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 se deben mostrar en fragmentos llamando a successCallback
varias veces. En caso de error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
successCallback
función
El parámetro
successCallback
se ve de la siguiente manera:(entries: EntryMetadata[], hasMore: boolean) => void
-
entradas
-
hasMore
boolean
-
-
errorCallback
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 abierto anteriormente con openRequestId
. Los resultados se deben mostrar en fragmentos llamando a successCallback
varias veces. En caso de error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
successCallback
función
El parámetro
successCallback
se ve de la siguiente manera:(data: ArrayBuffer, hasMore: boolean) => void
-
datos
ArrayBuffer
-
hasMore
boolean
-
-
errorCallback
función
El parámetro
errorCallback
se ve de la siguiente manera:(error: ProviderError) => void
-
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
función
El parámetro
callback
se ve de la siguiente manera:(options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onTruncateRequested
chrome.fileSystemProvider.onTruncateRequested.addListener(
callback: function,
)
Se genera cuando se solicita el truncamiento de un archivo para alcanzar la longitud deseada. Si se produce un error, se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onUnmountRequested
chrome.fileSystemProvider.onUnmountRequested.addListener(
callback: function,
)
Se genera cuando se desactiva para el sistema de archivos con el identificador fileSystemId
. En la respuesta, se debe llamar al método de la API unmount
junto con successCallback
. Si no es posible desactivar la función (p. ej., debido a una operación pendiente), se debe llamar a errorCallback
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-
onWriteFileRequested
chrome.fileSystemProvider.onWriteFileRequested.addListener(
callback: function,
)
Se genera cuando se escribe el contenido en un archivo abierto antes con openRequestId
.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
opciones
-
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
-
error
-
-