chrome.syncFileSystem

Mô tả

Sử dụng API chrome.syncFileSystem để lưu và đồng bộ hoá dữ liệu trên Google Drive. API này KHÔNG dùng để truy cập vào tài liệu tuỳ ý của người dùng được lưu trữ trong Google Drive. Thư viện này cung cấp bộ nhớ có thể đồng bộ hoá dành riêng cho ứng dụng để sử dụng khi không có mạng và lưu vào bộ nhớ đệm, nhờ đó, cùng một dữ liệu có thể được cung cấp trên nhiều ứng dụng khách. Hãy đọc bài viết Quản lý dữ liệu để biết thêm thông tin về cách sử dụng API này.

Quyền

syncFileSystem

Loại

ConflictResolutionPolicy

Enum

"last_write_win"

"manual"

FileInfo

Thuộc tính

  • hành động

    SyncAction không bắt buộc

    Thao tác đồng bộ hoá được thực hiện để kích hoạt sự kiện onFileStatusChanged. Giá trị hành động có thể là 'added', 'updated' hoặc 'deleted'. Chỉ áp dụng nếu trạng thái là 'synced'.

  • chỉ đường

    SyncDirection không bắt buộc

    Hướng đồng bộ hoá cho sự kiện onFileStatusChanged. Giá trị hướng đồng bộ hoá có thể là 'local_to_remote' hoặc 'remote_to_local'. Chỉ áp dụng nếu trạng thái là 'synced'.

  • fileEntry

    Mục nhập

    fileEntry cho tệp đích có trạng thái đã thay đổi. Chứa thông tin tên và đường dẫn của tệp được đồng bộ hoá. Khi tệp bị xoá, thông tin fileEntry vẫn sẽ có sẵn nhưng tệp sẽ không còn tồn tại.

  • trạng thái

    FileStatus

    Trạng thái tệp kết quả sau sự kiện onFileStatusChanged. Giá trị trạng thái có thể là 'synced', 'pending' hoặc 'conflicting'.

FileStatus

Enum

"đã đồng bộ hoá"
Không xung đột và không có thay đổi nào đang chờ xử lý trên máy.

"đang chờ xử lý"
Có một hoặc nhiều thay đổi cục bộ đang chờ xử lý và chưa được đồng bộ hoá.

"xung đột"
Tệp xung đột với phiên bản từ xa và phải được giải quyết theo cách thủ công.

FileStatusInfo

Thuộc tính

  • error

    chuỗi không bắt buộc

    Lỗi không bắt buộc chỉ được trả về nếu xảy ra lỗi khi truy xuất FileStatus cho tệp đã cho.

  • fileEntry

    Mục nhập

    Một trong các Mục ban đầu được cấp cho getFileStatuses.

  • trạng thái

    FileStatus

    Giá trị trạng thái có thể là 'synced', 'pending' hoặc 'conflicting'.

ServiceInfo

Thuộc tính

ServiceStatus

Enum

"initializing" (đang khởi chạy)
Dịch vụ đồng bộ hoá đang được khởi chạy (ví dụ: khôi phục dữ liệu từ cơ sở dữ liệu, kiểm tra khả năng kết nối và xác thực dịch vụ, v.v.).

"running"
Dịch vụ đồng bộ hoá đang hoạt động.

"authentication_required"
Dịch vụ đồng bộ hoá không đồng bộ hoá tệp vì người dùng cần xác thực dịch vụ từ xa để tiếp tục.

"temporary_unavailable"
Dịch vụ đồng bộ hoá không đồng bộ hoá các tệp vì dịch vụ từ xa (tạm thời) không hoạt động do một số lỗi có thể khắc phục, ví dụ: mạng ngoại tuyến, dịch vụ từ xa bị lỗi hoặc không thể truy cập, v.v. Thông tin chi tiết hơn sẽ được cung cấp theo tham số description trong OnServiceInfoUpdated (có thể chứa thông tin chi tiết theo từng dịch vụ).

"disabled"
Dịch vụ đồng bộ hoá bị tắt và nội dung sẽ không bao giờ đồng bộ hoá. (Ví dụ: điều này có thể xảy ra khi người dùng không có tài khoản trên dịch vụ từ xa hoặc dịch vụ đồng bộ hoá gặp lỗi không khôi phục được.)

StorageInfo

Thuộc tính

  • quotaBytes

    số

  • usageBytes

    số

SyncAction

Enum

"đã thêm"

"đã cập nhật"

"đã xoá"

SyncDirection

Enum

"local_to_remote"

"remote_to_local"

Phương thức

getConflictResolutionPolicy()

Promise 
chrome.syncFileSystem.getConflictResolutionPolicy(
  callback?: function,
)

Lấy chính sách xử lý xung đột hiện tại.

Tham số

Giá trị trả về

  • Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getFileStatus()

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

Trả về FileStatus cho fileEntry đã cho. Giá trị trạng thái có thể là 'synced', 'pending' hoặc 'conflicting'. Xin lưu ý rằng trạng thái 'conflicting' chỉ xảy ra khi chính sách giải quyết xung đột của dịch vụ được đặt thành 'manual'.

Tham số

  • fileEntry

    Mục nhập

  • lệnh gọi lại

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (status: FileStatus) => void

Giá trị trả về

  • Promise<FileStatus>

    Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getFileStatuses()

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

Trả về từng FileStatus cho mảng fileEntry đã cho. Thường được gọi bằng kết quả từ dirReader.readEntries().

Tham số

  • fileEntries

    object[]

  • lệnh gọi lại

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (status: FileStatusInfo[]) => void

Giá trị trả về

  • Promise<FileStatusInfo[]>

    Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getServiceStatus()

Promise 
chrome.syncFileSystem.getServiceStatus(
  callback?: function,
)

Trả về trạng thái phụ trợ đồng bộ hoá hiện tại.

Tham số

  • lệnh gọi lại

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (status: ServiceStatus) => void

Giá trị trả về

  • Promise<ServiceStatus>

    Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getUsageAndQuota()

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

Trả về mức sử dụng và hạn mức hiện tại tính bằng byte cho bộ nhớ tệp 'syncable' của ứng dụng.

Tham số

  • fileSystem

    DOMFileSystem

  • lệnh gọi lại

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (info: StorageInfo) => void

Giá trị trả về

  • Promise<StorageInfo>

    Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

requestFileSystem()

Promise 
chrome.syncFileSystem.requestFileSystem(
  callback?: function,
)

Trả về một hệ thống tệp có thể đồng bộ hoá được Google Drive hỗ trợ. Bạn có thể thao tác trên thực thể DOMFileSystem được trả về theo cách tương tự như các hệ thống tệp Tạm thời và Hằng số (xem http://dev.w3.org/2009/dap/file-system/file-dir-sys.html).

Việc gọi hàm này nhiều lần từ cùng một ứng dụng sẽ trả về cùng một handle cho cùng một hệ thống tệp.

Xin lưu ý rằng lệnh gọi này có thể không thành công. Ví dụ: nếu người dùng chưa đăng nhập vào Chrome hoặc nếu không có hoạt động mạng nào. Để xử lý các lỗi này, bạn cần kiểm tra chrome.runtime.lastError trong lệnh gọi lại.

Tham số

  • lệnh gọi lại

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (fileSystem: DOMFileSystem) => void

    • fileSystem

      DOMFileSystem

Giá trị trả về

  • Promise<DOMFileSystem>

    Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setConflictResolutionPolicy()

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

Đặt chính sách giải quyết xung đột mặc định cho bộ nhớ tệp 'syncable' cho ứng dụng. Theo mặc định, chính sách này được đặt thành 'last_write_win'. Khi bạn đặt chính sách giải quyết xung đột thành 'last_write_win', các xung đột đối với tệp hiện có sẽ tự động được giải quyết vào lần tiếp theo tệp được cập nhật. Bạn có thể cung cấp callback (không bắt buộc) để biết yêu cầu có thành công hay không.

Tham số

  • lệnh gọi lại

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 117 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onFileStatusChanged

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

Được kích hoạt khi một tệp đã được dịch vụ đồng bộ hoá ở chế độ nền cập nhật.

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback có dạng như sau: 

    (detail: FileInfo) => void

onServiceStatusChanged

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

Được kích hoạt khi xảy ra lỗi hoặc thay đổi trạng thái khác trong phần phụ trợ đồng bộ hoá (ví dụ: khi quá trình đồng bộ hoá bị tạm thời vô hiệu hoá do lỗi mạng hoặc lỗi xác thực).

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback có dạng như sau: 

    (detail: ServiceInfo) => void