chrome.syncFileSystem

This API is part of the deprecated Chrome Apps platform. Learn more about migrating your app.

Description
Use the chrome.syncFileSystem API to save and synchronize data on Google Drive. This API is NOT for accessing arbitrary user docs stored in Google Drive. It provides app-specific syncable storage for offline and caching usage so that the same data can be available across different clients. Read Manage Data for more on using this API.
Permissions
syncFileSystem

Summary

Types
ConflictResolutionPolicy
FileInfo
FileStatus
FileStatusInfo
ServiceInfo
ServiceStatus
StorageInfo
SyncAction
SyncDirection
Methods
getConflictResolutionPolicy
getFileStatus
getFileStatuses
getServiceStatus
getUsageAndQuota
requestFileSystem
setConflictResolutionPolicy
Events
onFileStatusChanged
onServiceStatusChanged

Types

ConflictResolutionPolicy

Type

"last_write_win"

, or

"manual"

FileInfo

Properties

action
SyncAction optional
Sync action taken to fire onFileStatusChanged event. The action value can be 'added', 'updated' or 'deleted'. Only applies if status is 'synced'.
direction
SyncDirection optional
Sync direction for the onFileStatusChanged event. Sync direction value can be 'local_to_remote' or 'remote_to_local'. Only applies if status is 'synced'.
fileEntry
Entry
fileEntry for the target file whose status has changed. Contains name and path information of synchronized file. On file deletion, fileEntry information will still be available but file will no longer exist.
status
FileStatus
Resulting file status after onFileStatusChanged event. The status value can be 'synced', 'pending' or 'conflicting'.

FileStatus

Type

"synced"

"pending"

, or

"conflicting"

FileStatusInfo

Properties

error
string optional
Optional error that is only returned if there was a problem retrieving the FileStatus for the given file.
fileEntry
Entry
One of the Entry's originally given to getFileStatuses.
status
FileStatus
The status value can be 'synced', 'pending' or 'conflicting'.

ServiceInfo

Properties

description
string
state
ServiceStatus

ServiceStatus

Type

"initializing"

"running"

"authentication_required"

"temporary_unavailable"

, or

"disabled"

StorageInfo

Properties

quotaBytes
number
usageBytes
number

SyncAction

Type

"added"

"updated"

, or

"deleted"

SyncDirection

Type

"local_to_remote"

, or

"remote_to_local"

Methods

getConflictResolutionPolicy

chrome.syncFileSystem.getConflictResolutionPolicy(
  callback: function,
)

Gets the current conflict resolution policy.

Parameters

callback
function
The callback parameter looks like: (policy: ConflictResolutionPolicy) => void
- policy
  ConflictResolutionPolicy

getFileStatus

chrome.syncFileSystem.getFileStatus(
  fileEntry: Entry,
  callback: function,
)

Returns the FileStatus for the given fileEntry. The status value can be 'synced', 'pending' or 'conflicting'. Note that 'conflicting' state only happens when the service's conflict resolution policy is set to 'manual'.

Parameters

fileEntry
Entry
callback
function
The callback parameter looks like: (status: FileStatus) => void
- status
  FileStatus

getFileStatuses

chrome.syncFileSystem.getFileStatuses(
  fileEntries: object[],
  callback: function,
)

Returns each FileStatus for the given fileEntry array. Typically called with the result from dirReader.readEntries().

Parameters

fileEntries
object[]
callback
function
The callback parameter looks like: (status: FileStatusInfo[]) => void
- status
  FileStatusInfo[]

getServiceStatus

chrome.syncFileSystem.getServiceStatus(
  callback: function,
)

Returns the current sync backend status.

Parameters

callback
function
The callback parameter looks like: (status: ServiceStatus) => void
- status
  ServiceStatus

getUsageAndQuota

chrome.syncFileSystem.getUsageAndQuota(
  fileSystem: DOMFileSystem,
  callback: function,
)

Returns the current usage and quota in bytes for the 'syncable' file storage for the app.

Parameters

fileSystem
DOMFileSystem
callback
function
The callback parameter looks like: (info: StorageInfo) => void
- info
  StorageInfo

requestFileSystem

chrome.syncFileSystem.requestFileSystem(
  callback: function,
)

Returns a syncable filesystem backed by Google Drive. The returned DOMFileSystem instance can be operated on in the same way as the Temporary and Persistant file systems (see http://dev.w3.org/2009/dap/file-system/file-dir-sys.html).

Calling this multiple times from the same app will return the same handle to the same file system.

Note this call can fail. For example, if the user is not signed in to Chrome or if there is no network operation. To handle these errors it is important chrome.runtime.lastError is checked in the callback.

Parameters

callback
function
The callback parameter looks like: (fileSystem: DOMFileSystem) => void
- fileSystem
  DOMFileSystem

setConflictResolutionPolicy

chrome.syncFileSystem.setConflictResolutionPolicy(
  policy: ConflictResolutionPolicy,
  callback?: function,
)

Sets the default conflict resolution policy for the 'syncable' file storage for the app. By default it is set to 'last_write_win'. When conflict resolution policy is set to 'last_write_win' conflicts for existing files are automatically resolved next time the file is updated. callback can be optionally given to know if the request has succeeded or not.

Parameters

policy
ConflictResolutionPolicy
callback
function optional
The callback parameter looks like: () => void

Events

onFileStatusChanged

chrome.syncFileSystem.onFileStatusChanged.addListener(
  callback: function,
)

Fired when a file has been updated by the background sync service.

Parameters

callback
function
The callback parameter looks like: (detail: FileInfo) => void
- detail
  FileInfo

onServiceStatusChanged

chrome.syncFileSystem.onServiceStatusChanged.addListener(
  callback: function,
)

Fired when an error or other status change has happened in the sync backend (for example, when the sync is temporarily disabled due to network or authentication error).

Parameters

callback
function
The callback parameter looks like: (detail: ServiceInfo) => void
- detail
  ServiceInfo