Memperbarui ekstensi Anda sebelum perubahan mendatang pada sinkronisasi bookmark

James Lee
James Lee

Dipublikasikan: 17 Juni 2025

Agustus lalu, kami mengumumkan perubahan mendatang pada model identitas Chrome di platform Windows, Mac, dan Linux, setelah perubahan yang telah diluncurkan di iOS dan Android. Tujuan dari perubahan ini adalah untuk menyelaraskan Chrome dengan ekspektasi pengguna saat ini terkait login. Pengguna semakin berharap untuk cukup login guna mendapatkan akses ke data mereka, termasuk bookmark, dan logout untuk menjaga keamanannya.

Sebagai bagian dari peluncuran update ini, kami memperkenalkan perubahan pada cara Chrome menyimpan bookmark di desktop. Misalnya, bookmark yang disimpan secara lokal di perangkat akan tetap bersifat lokal saat login; pengguna dapat memilih untuk mengupload data tersebut ke Akun Google mereka satu per satu atau secara massal. Untuk memungkinkan ekstensi mendukungnya, kami mengekspos data baru di Chrome Extensions API. Informasi berikut relevan bagi semua penulis Ekstensi Chrome yang menggunakan chrome.bookmarks API.

Ringkasan

Saat ini, pengguna selalu memiliki satu set folder tingkat teratas, termasuk folder "Panel bookmark" dan "Bookmark lainnya". Data dalam folder ini mungkin disinkronkan atau tidak, bergantung pada apakah pengguna login dengan sinkronisasi diaktifkan atau tidak.

Sebagai bagian dari perubahan model identitas, Chrome akan memisahkan bookmark yang disinkronkan dan yang tidak disinkronkan menjadi dua subpohon terpisah di pohon bookmark. Dalam beberapa kasus saat pengguna belum memilih untuk mengupload semua bookmark ke akunnya, pengguna mungkin memiliki folder bookmark yang disinkronkan dan tidak disinkronkan secara bersamaan. Ekstensi yang menggunakan API bookmark mungkin perlu diupdate, agar dapat menampilkan hierarki bookmark dengan cara yang jelas bagi pengguna.

Perubahan API mendetail

Untuk pengguna dengan campuran bookmark yang disinkronkan dan tidak disinkronkan, API bookmark dapat menampilkan hierarki yang mirip dengan berikut ini di getTree API:

  • id=A (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: true)
    • …
  • id=B (name: "Other bookmarks", folderType: "other", syncing: true)
    • …
  • id=C (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: false)
    • …
  • id=D (name: "Other bookmarks", folderType: "other", syncing: false)
    • …

Untuk memungkinkan developer ekstensi membedakan antara folder tingkat teratas ini, dua properti baru telah ditambahkan ke API:

  • folderType: memungkinkan ekstensi mengidentifikasi folder "khusus" seperti panel bookmark. Perhatikan bahwa name dan id tidak boleh digunakan untuk tujuan ini (name bergantung pada lokalitas, dan id tidak tetap)
  • syncing: untuk mengizinkan ekstensi membedakan antara bagian sinkronisasi dan non-sinkronisasi dari hierarki. Nilai ini akan menjadi true sebelum model identitas berubah jika pengguna login dan mengaktifkan sinkronisasi.

Update ekstensi

Jika salah satu hal berikut berlaku untuk ekstensi Anda, Anda mungkin perlu melakukan pembaruan:

  • Jika ekstensi Anda menampilkan hasil lengkap getTree kepada pengguna untuk mencegah versi bernama identik, misalnya, kolom bookmark ditampilkan. Anda dapat menambahkan akhiran ke nama, atau memberikan perlakuan UI lainnya.
  • Jika ekstensi Anda mencoba mencocokkan folder permanen bookmarks-bar, other, atau mobile dengan id atau name. Metode ini sudah tidak didukung.
  • Jika ekstensi Anda mengasumsikan bahwa ada tepat atau paling banyak satu instance folder permanen bookmarks-bar, other, atau mobile

Pengujian

Properti API ekstensi folderType dan syncing baru didokumentasikan dan tersedia di rilis Chrome Canary terbaru (versi 138.0.7196.0 atau yang lebih baru).

Pengguna di saluran Chrome stabil memiliki satu penyimpanan (yaitu, paling banyak satu dari setiap jenis folder). Untuk tujuan pengujian, Anda dapat mengaktifkan penyimpanan ganda sebagai berikut:

  1. Aktifkan keduanya di chrome://flags, lalu mulai ulang Chrome
    • sync-enable-bookmarks-in-transport-mode
    • enable-bookmarks-selected-type-on-signin-for-testing
  2. Tambahkan profil Chrome baru (https://support.google.com/chrome/answer/2364824)
    • Jangan login: pilih "Lanjutkan tanpa akun".
  3. Jika Anda mem-bookmark halaman, halaman tersebut akan ditambahkan ke penyimpanan yang tidak disinkronkan.
  4. Sekarang login ke Chrome:
    • Klik gambar avatar tersebut di kanan atas, di samping menu tiga titik.
    • Klik "Login ke Chrome" dan ikuti petunjuknya.
    • Pilih "Tidak, terima kasih" saat ditanya apakah Anda ingin mengaktifkan sinkronisasi.
  5. Jika Anda mem-bookmark halaman, halaman tersebut akan ditambahkan ke penyimpanan sinkronisasi (memungkinkan Anda menguji kasus penyimpanan ganda).

Jadwal

Perubahan untuk mengekspos penyimpanan ganda akan diluncurkan secara bertahap, dan akan mulai diluncurkan untuk sebagian pengguna saluran Stabil Chrome paling cepat akhir Juni 2025, dimulai untuk sebagian kecil pengguna, lalu diluncurkan secara lebih luas selama beberapa minggu berikutnya.