Lewati ke konten utama

Penyimpanan jarak jauh

Mengirim seluruh keadaan editor pada setiap perubahan tidak efisien.
Untuk kasus tersebut, editor menyediakan API untuk replikasi data waktu nyata.

Instalasi​

npm install @dineug/erd-editor

Store replikasi berada di subpath @dineug/erd-editor/engine.js, bukan di root paket.
Titik masuk itu tidak menyentuh DOM, sehingga berjalan di Web Worker atau di mana pun di luar thread utama.
Sebaliknya, mengimpor root paket memerlukan dokumen: sejak 5.0.0 root tidak mendefinisikan elemen apa pun, tetapi mengevaluasinya membangun kedua kelas elemen. Sebelum 5.0.0, root mendaftarkan elemen kustom <erd-editor>.

Penggunaan​

type ReplicationStore = {
  readonly value: string;
  readonly runtimeValue: string;
  on: (
    listeners: Partial<{ change: (change: ReplicationChange) => void }>
  ) => Unsubscribe;
  setInitialValue: (value: string) => void;
  dispatch: (actions: Array<AnyAction> | AnyAction) => void;
  dispatchSync: (actions: Array<AnyAction> | AnyAction) => void;
  destroy: () => void;
};

type ReplicationChange = {
  value: string;
  changed: boolean;
};

type InjectEngineContext = {
  toWidth: (text: string) => number;
};

type CreateReplicationStore = (
  context: InjectEngineContext
) => ReplicationStore;

// example
import { createReplicationStore } from '@dineug/erd-editor/engine.js';

const replicationStore = createReplicationStore({
  toWidth: text => text.length * 10,
});

Mereplikasi editor yang sedang berjalan​

Aksi berasal dari shared store milik editor yang sedang berjalan.
Lihat Pengeditan kolaboratif.

import { createReplicationStore } from '@dineug/erd-editor/engine.js';

const replicationStore = createReplicationStore({ toWidth });
replicationStore.setInitialValue(editor.runtimeValue);

replicationStore.on({
  change: ({ value, changed }) => {
    if (changed) save(value);
  },
});

const sharedStore = editor.getSharedStore();
sharedStore.subscribe(actions => {
  replicationStore.dispatch(actions);
});

Hanya perubahan yang melintasi batas, tidak pernah seluruh dokumen.
Replika menerapkannya dan menserialisasi hasilnya di sisinya sendiri.
change memberikan hasil itu kepada Anda sebagai value, dan changed memberi tahu kapan hasil itu layak ditulis.

Sejak 4.0.0, isi data awal replika dari runtimeValue milik editor, seperti di atas, bukan dari file yang disimpan atau dari value milik editor.
File tidak memuat perubahan yang dibuat sejak file itu disimpan, dan value tidak memuat entitas yang dihapus dalam sesi.
Replika yang data awalnya diisi tanpa tabel yang telah dihapus memunculkan kembali tabel itu tanpa nama maupun kolomnya saat sebuah editor membatalkan penghapusannya, lalu menyimpannya dalam keadaan demikian.
Sejak 4.2.0, hal yang sama berlaku untuk kata, istilah, atau domain yang dihapus dari lembar di tab Kamus.
Saat sebuah editor membatalkan penghapusannya, replika yang data awalnya diisi tanpa baris tersebut mencantumkannya kembali dalam keadaan kosong, dan karena value tidak menyertakan baris kosong, replika menyimpan dokumen tanpa baris itu.
Untuk domain, kolom dan istilah yang tertaut ke domain itu juga tetap tidak tertaut di replika tersebut, karena replika tidak pernah memegang tautannya dan pembatalan tidak mengirimkannya.

Sejak 5.1.0, @dineug/erd-editor-yjs juga dapat menjaga editor tetap selaras melalui room Yjs.
Jika diumpankan seperti di atas dari elemen yang terikat ke sebuah room, replika hanya menerima edit yang dibuat di elemen itu, tidak pernah edit yang dibawa masuk room: edit tersebut sampai ke elemen sebagai edit editor lain, dan shared store tidak pernah meneruskan apa yang diterimanya.
Untuk menyimpan dokumen sebuah room, simpan value elemen yang terikat, atau milik peer store yang terikat, seperti dijelaskan Isi room.
Provider persistensi Yjs menyimpan room itu sendiri, yang memuat nilai runtime dan edit yang dibuat sesudahnya, bukan sebuah file; lihat Batasan.

InjectEngineContext​

toWidth​

Mengukur string dalam piksel.
Store tidak memiliki DOM, sehingga tidak dapat mengukur teks sendiri, dan store menghitung ulang lebar kolom dari fungsi ini setiap kali nama, tipe data, nilai default, atau komentar berubah.
Sejak 4.2.0, hal itu mencakup nama logis tabel atau kolom.
Store mengukur sel Domain milik kolom, yang menampilkan nama domain yang tertaut ke kolom tersebut, setiap kali kolom ditautkan ke domain atau dilepas tautannya, dan setiap kali domain itu ditambahkan, diganti namanya, atau dihapus.
Store juga mengukur ulang setiap tabel dan kolom setiap kali setInitialValue memuat dokumen.
Sejak 4.0.0, lebar hanya disimpan di runtimeValue, tidak pernah di value.
Jadi, dokumen yang disimpan oleh rilis ini terbaca kembali menjadi value yang sama persis byte demi byte, di mana pun dokumen itu disimpan dan bagaimanapun teks diukur di sana.

Ukur dengan cara yang sama seperti editor — 400 12px dalam font stack editor, dibulatkan, ditambah padding 2px.
Jika tidak, lebar di runtimeValue menyimpang dari lebar yang tampil di layar.

const TEXT_PADDING = 2;
const FONT =
  "400 12px -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, " +
  "'Helvetica Neue', 'Open Sans', system-ui, sans-serif, " +
  "'Apple Color Emoji', 'Segoe UI Emoji'";

let context = null;

function getContext() {
  if (context) return context;

  try {
    context = new OffscreenCanvas(0, 0).getContext('2d');
    if (context) context.font = FONT;
  } catch {
    // no canvas available
  }

  return context;
}

function toWidth(text) {
  const context = getContext();
  const width = context ? context.measureText(text).width : text.length * 10;

  return Math.round(width) + TEXT_PADDING;
}

const replicationStore = createReplicationStore({ toWidth });

text.length * 10 adalah cadangan saat tidak ada kanvas yang tersedia.
Cara ini cukup untuk store yang dokumennya hanya disimpan, tidak pernah dirender.

ReplicationStore​

value getter​

Menserialisasi keadaan editor saat ini.
Mengembalikan string JSON yang siap disimpan apa adanya — bukan objek yang sudah diurai.

const data = replicationStore.value;

Sejak 4.0.0, value adalah bentuk penyimpanan: dokumen sebagaimana tersimpan di file, teks yang sama dengan yang dikembalikan value milik elemen.
Isinya hanya entitas yang masih ada, dalam urutan tetap, tanpa entitas yang dihapus, urutan tumpukan, atau apa pun yang dihitung kembali oleh pemuatan, seperti lebar yang diukur toWidth.
Sejak 4.2.0, isinya juga mencakup nama logis, keterangan apakah setiap nama dihasilkan dari kamus, tautan domain, serta kata, istilah, dan domain di tab Kamus.
Sejak 4.2.0 pula, nilai ini tidak menyertakan setiap field teks entitas yang kosong, setiap daftar doc dan koleksi yang tidak berisi apa pun, serta collections itu sendiri jika setiap koleksi kosong.
Teksnya diindentasi dua spasi, dengan setiap baris kamus pada baris teksnya sendiri, dan diakhiri baris baru, sehingga dokumen yang sama selalu menghasilkan byte yang sama.
Lihat Bentuk penyimpanan untuk mengetahui isinya.

Setiap pengaturan dengan penguncian aktif ditulis dengan nilai saat pengaturan itu dikunci, dan setiap pengaturan lain ditulis sebagaimana adanya.
Penguncian Viewport mencakup titik asal area pandang dan tingkat zoom sekaligus, sedangkan tab, bahasa Generator Kode, kedua konvensi penamaan, dan tipe tanda kutip masing-masing memiliki penguncian sendiri.
Sejak 4.2.0, begitu pula Tampilan Nama, yang penguncian Name View-nya aktif di dokumen baru.
Penguncian ini menggantikan ignoreSaveSettings milik dokumen, yang tidak dibaca maupun ditulis sejak 4.0.0.
Sebelum 4.0.0, value adalah seluruh dokumen sebagaimana adanya di store, dengan bit guliran dan zoom milik field itu diterapkan.

runtimeValue getter​

Sejak 4.0.0, menserialisasi dokumen sebagaimana adanya di replika, termasuk entitas yang dihapus dan semua yang dihitung kembali oleh pemuatan.
Di sini pun, setiap pengaturan yang terkunci ditulis dengan nilai terkuncinya.

const snapshot = replicationStore.runtimeValue;

Gunakan untuk mengisi data awal editor atau store lain yang bergabung belakangan, melalui setInitialValue miliknya; lihat Pengeditan kolaboratif.
Replika tidak memiliki getLWW atau getVersion, sehingga tidak menyerahkan register kolaborasi melalui runtimeValue: editor yang data awalnya diisi darinya mengambil register itu dari editor yang sedang berjalan, seperti dijelaskan Mengisi data awal kolaborator.
Jangan pernah menyimpannya sebagai file: nilai ini membawa entitas yang dihapus, dan JSON Schema yang dipublikasikan menolaknya.
Entitas yang dihapus itulah yang memungkinkan pembatalan sebuah penghapusan, yang dikirim belakangan, mengembalikan entitas secara utuh di store yang data awalnya diisi dari nilai ini.
Entitas tersebut tetap ada hingga dokumen dibuka lagi dari filenya, yang bentuknya tidak menyertakan entitas itu.

setInitialValue​

Memuat keadaan editor yang sebelumnya disimpan.

replicationStore.setInitialValue('json...');

Metode ini menerima bentuk penyimpanan, nilai runtime, atau dokumen yang disimpan oleh rilis sebelumnya, termasuk dokumen v2.
String kosong, atau apa pun yang bukan string, memuat dokumen baru yang kosong alih-alih memunculkan kesalahan.
Store yang belum pernah diberi nilai dimulai sebagai dokumen baru yang sama.
Sejak 4.0.0, semua penguncian dokumen tersebut aktif, sehingga value dokumen itu mempertahankan area pandang, tab, bahasa Generator Kode, konvensi penamaan, dan tipe tanda kutip awalnya selama editor yang direplikasinya menggulir, melakukan zoom, berpindah tab, atau mengubah pengaturan tersebut. Di 3.10.0, dokumen itu tidak menyimpan guliran maupun zoom, dan sebelum itu menyimpan keduanya.
Sejak 4.2.0, dokumen itu juga mempertahankan Tampilan Namanya, Physical Names, selama editor yang direplikasinya mengganti Tampilan Nama masing-masing.
Dokumen yang tersimpan mempertahankan penguncian yang disebutkannya.
Dokumen yang tidak menyebutkan penguncian apa pun, yaitu setiap dokumen yang disimpan sebelum 4.0.0, termasuk dokumen v2, dimuat dengan semua penguncian aktif: titik asal area pandangnya di 0, 0, tingkat zoomnya di 1, dan tabnya di ERD, apa pun yang disimpannya, serta bahasa Generator Kode, konvensi penamaan, dan tipe tanda kutipnya sebagaimana disimpan.
Dokumen yang disimpan sebelum 4.2.0 tidak menyebutkan penguncian Name View, sehingga dimuat dengan penguncian itu aktif dan dalam tampilan Physical Names, bahkan dokumen yang disimpan dengan semua penguncian lainnya nonaktif.
Sejak 4.0.0, setInitialValue juga membuang register kolaborasi yang disimpan untuk dokumen sebelumnya, seperti yang dilakukan setInitialValue milik elemen.
Teks yang bukan JSON, seperti file yang masih berisi penanda konflik merge, juga tidak memunculkan kesalahan: kesalahan penguraian hanya dicatat ke konsol, dokumen dikosongkan, dan pengaturan tetap seperti semula.

Sejak 4.0.0, pemuatan tidak menjalankan garbage collection, sehingga entitas yang dihapus tetap berada di runtimeValue.
Sebelumnya, pemuatan membuang entitas yang tidak lagi muncul di doc dan tidak disentuh selama empat hari atau lebih.

Penulisan ulang oleh pemuatan sudah tuntas sebelum setInitialValue selesai dijalankan: tanda kunci pada kolom, yang dibaca dari opsi setiap kolom dan dari hubungan; setiap lebar tabel dan kolom, yang diukur ulang dengan toWidth; titik tempat setiap konektor bertemu tabelnya; serta penanda pengidentifikasi setiap hubungan dan simbol di ujung induknya.
Tidak satu pun dari semua itu merupakan bagian dari value, tetapi replicationStore.runtimeValue yang dibaca tepat setelah pemanggilan sudah memuat semuanya.
Aksi yang tiba tepat setelah pemuatan, seperti guliran yang diputar ulang, diukur terhadap dokumen yang dimuat, sehingga pemuatan itu sendiri tidak pernah dilaporkan sebagai changed.

Baik pemuatan maupun penulisan ulang mana pun di atas tidak memancarkan change.
Baca sendiri replicationStore.value setelah setInitialValue selesai dijalankan jika Anda ingin dokumen yang dimuat ditulis kembali dalam bentuk penyimpanan.

on@change​

Berlangganan perubahan pada keadaan editor.

const unsubscribe = replicationStore.on({
  change: ({ value, changed }) => {
    if (changed) {
      // save value...
    }
  },
});

change di-debounce selama 200ms, sehingga serangkaian aksi beruntun tiba sebagai satu notifikasi.
Event ini hanya dipicu oleh aksi dari jenis yang dapat mengubah dokumen, ditambah settings.changeIgnoreSaveSettings yang mungkin masih dikirim oleh editor lama (lihat dispatch, dispatchSync).
Aksi kehadiran yang diteruskan atau editor.mergeLWW tidak pernah membangunkannya.
Panggil fungsi yang dikembalikan untuk berhenti berlangganan.

Sejak 3.10.0, listener menerima ReplicationChange, tipe yang diekspor @dineug/erd-editor/engine.js di samping ReplicationStore.
Sebelum 3.10.0, listener tidak menerima apa pun, dan listener yang mengabaikan argumen tersebut tetap berfungsi.
value adalah dokumen yang diserialisasi dalam bentuk penyimpanan, string yang sama dengan yang dikembalikan replicationStore.value pada saat itu, sehingga tidak perlu menserialisasinya lagi.
changed bernilai false saat aksi sejak change sebelumnya, atau sejak pemuatan, membiarkan value tetap sama persis byte demi byte.

Perubahan yang tidak dimasukkan ke value karena penguncian tetap memicu change, dengan changed bernilai false, jadi tulis hanya saat changed bernilai true.
Perubahan tersebut berupa guliran atau zoom selama Viewport terkunci, perpindahan tab selama Canvas Type terkunci, dan perubahan bahasa Generator Kode, konvensi penamaan, atau tipe tanda kutip selama penguncian miliknya sendiri aktif, yang sejak 5.1.0 hanya masih dikirim oleh editor sebelum 5.1.0 (lihat dispatch, dispatchSync).
Sejak 4.2.0, begitu pula penggantian Tampilan Nama selama Name View terkunci: editor tetap mengirimkannya, tetapi replika membuangnya, seperti yang dilakukan editor lain.
Penggantian Tampilan Nama yang dilakukan di editor hanya baca dibuang dengan cara yang sama, apa pun keadaan penguncian Tampilan Nama.
Event change milik elemen tidak menyertakan perubahan semacam itu, tetapi replika tetap melaporkannya.
Semua penguncian aktif di dokumen baru dan di dokumen yang disimpan sebelum 4.0.0, dan Name View terkunci di dokumen apa pun yang disimpan sebelum 4.2.0.
Saat Viewport tidak terkunci, guliran atau zoom mengubah value, saat Canvas Type tidak terkunci, begitu pula membuka tab editor yang lain, dan saat Name View tidak terkunci, begitu pula penggantian Tampilan Nama dari editor yang tidak hanya baca.
Mengaktifkan atau menonaktifkan penguncian juga mengubah value.

Sejak 4.0.0, changed membandingkan bentuk penyimpanan, yang tidak memuat entitas yang dihapus maupun urutan tumpukan.
Jadi, tabel yang ditambahkan lalu dihapus lagi dalam satu change, perubahan yang mengenai entitas yang telah dihapus kolaborator lain, dan pemuatan yang diteruskan yang hanya mengubah urutan tumpukan semuanya juga menghasilkan changed bernilai false.
Sejak 4.2.0, begitu pula baris yang ditambahkan ke lembar kamus lalu dibiarkan kosong, karena bentuk penyimpanan tidak menyertakan baris yang tidak berisi apa pun.

changed tidak pernah membandingkan dengan file yang Anda simpan, yang mungkin sudah berbeda dari value begitu file itu dimuat: file yang disimpan oleh rilis sebelumnya berbeda, termasuk file v2, begitu pula file yang diawali byte order mark dan file yang diedit secara manual.
Sejak 4.2.0, hal itu mencakup file yang disimpan 4.0.0 atau 4.1.0, karena value tidak menyertakan field teks kosong milik entitasnya serta daftar doc dan koleksi kosong yang dimuat file semacam itu.
Membandingkan byte dengan file semacam itu akan membuat guliran yang tidak dimasukkan karena penguncian pun terhitung sebagai perubahan.
change pertama dengan changed bernilai true mengembalikan file semacam itu dalam bentuk penyimpanan, sehingga menuliskannya menulis ulang file tersebut satu kali.
File yang disimpan oleh rilis ini tidak berbeda, di mana pun file itu disimpan, seperti dijelaskan di toWidth.
Jika setInitialValue dipanggil selama sebuah change masih tertunda, dan tidak ada yang dikirim sebelum waktunya tiba, change tersebut tetap datang, dengan value yang dimuat dan changed bernilai false.

dispatch, dispatchSync​

Menerapkan perubahan dari editor jarak jauh ke replicationStore.

replicationStore.dispatch(actions); // async
replicationStore.dispatchSync(actions); // sync

dispatch menunda penerapan ke microtask, dan dispatchSync langsung menerapkan batch tersebut.

Anda dapat meneruskan aliran shared store tanpa difilter.
Kedua metode hanya mempertahankan aksi dari jenis yang dapat mengubah dokumen, ditambah dua aksi yang dijelaskan di akhir bagian ini, dan membuang sisanya, sehingga data kehadiran yang dibawa sesi kolaboratif — kursor mouse, fokus, pilihan, dan kotak seret setiap pengguna — lewat tanpa efek apa pun.

Sejak 3.10.0, aksi yang dipertahankan mencakup relationship.changeOnDelete dan relationship.changeOnUpdate, dan relationship.add membawa onDelete dan onUpdate.
Store dari rilis sebelumnya membuang aksi tersebut dan mengabaikan field tersebut, sehingga kehilangan tindakan ON DELETE dan ON UPDATE milik hubungan.

Sejak 4.0.0, aksi yang dipertahankan juga mencakup table.changeGroup, tujuh dari delapan aksi tableGroup (tableGroup.add, tableGroup.move, tableGroup.moveTo, tableGroup.remove, tableGroup.resize, tableGroup.changeName, dan tableGroup.changeColor, semuanya kecuali perubahan urutan tumpukan tableGroup.changeZIndex), relationship.changeColumns, settings.changeLockSettings, dan settings.changeDDLScript.
settings.changeRelationshipOptimization sudah tidak ada lagi, sehingga kedua metode membuangnya.
Store dari rilis sebelumnya membuang aksi baru tersebut, sehingga kehilangan grup tabel, penguncian, skrip Skema SQL, dan kolom yang diberikan Petakan Kolom ke hubungan yang sudah ada.
Jalankan replika pada rilis yang sama dengan editor, atau rilis yang lebih baru.

4.1.0 tidak menambahkan tipe aksi apa pun dan membiarkan @dineug/erd-editor/engine.js seperti semula, sehingga replika 4.0.0 mempertahankan setiap perubahan yang dikirim editor 4.1.0, sama seperti replika 4.1.0.
Sejak 4.1.0, Replace dan Replace All di Temukan dan Ganti juga mengganti nama indeks dan grup tabel, melalui aksi index.changeName dan tableGroup.changeName yang sudah dipertahankan oleh replika 4.0.0.
Keadaan milik Penjelajah sendiri tidak pernah dikirim, dan perpindahan tab atau guliran yang dilakukannya tiba seperti perpindahan tab atau guliran lainnya; lihat Pengeditan kolaboratif.

Sejak 4.2.0, aksi yang dipertahankan juga mencakup table.changeLogicalName, table.changeNameDerived, column.changeLogicalName, column.changeDomain, column.changeNameDerived, settings.changeNameViewMode, serta dictionary.add, dictionary.update, dan dictionary.remove, yang membawa setiap perubahan, pengurutan, dan impor CSV di lembar tab Kamus.
Dari penggantian Tampilan Nama, replika hanya menerapkan penggantian yang dilakukan editor yang tidak hanya baca selama Name View tidak terkunci, dan membuang sisanya (lihat on@change).
Store dari rilis sebelumnya membuang semua aksi ini, sehingga kehilangan nama logis, tautan domain, keterangan apakah setiap nama berasal dari kamus, kata, istilah, dan domain, serta Tampilan Nama.
Editor sebelum 4.2.0 di dalam sesi masih dapat menghilangkan sebagian dari hal ini dari replika 4.2.0.
Import Skema SQL, GraphQL, DBML, atau AML di editor tersebut, tetapi bukan Import and Add, mengosongkan kata, istilah, dan domain milik replika.
Pembatalan pemuatan, Import, atau clear() oleh editor tersebut memuat salinan dokumennya sendiri ke replika, tanpa nama logis, tautan domain, atau kamus; lihat Mencampur rilis.
@dineug/erd-editor/engine.js mengekspor createReplicationStore, ReplicationStore, dan ReplicationChange yang sama seperti sebelumnya, dan createReplicationStore menerima konteks yang sama.

5.1.0 tidak menambahkan tipe aksi dan tidak mengubah ekspor @dineug/erd-editor/engine.js, sehingga replika dari 4.2.0 ke atas tetap menyimpan setiap perubahan yang dikirim editor 5.1.0.
Sejak 5.1.0, replika menentukan hasil edit yang dibuat pada saat yang sama dengan cara yang sama seperti editor 5.1.0; lihat Pengeditan pada saat yang sama.
Replika menyimpan sebuah versi untuk posisi tabel, untuk posisi dan ukuran memo serta grup tabel, dan untuk titik asal area pandang serta tingkat zoom.
Editor 5.1.0 mengirim seretan, geseran, atau zoom sebagai titik akhirnya, melalui table.moveTo, memo.moveTo, tableGroup.moveTo, settings.scrollTo, dan settings.changeZoomLevel, dan replika menerima masing-masing aksi itu, serta setiap memo.resize dan tableGroup.resize, hanya jika versinya tidak lebih rendah daripada versi yang dipegangnya.
Jadi, saat dua editor semacam ini memindahkan atau mengubah ukuran satu tabel, memo, atau grup tabel pada saat yang sama, replika menyimpannya pada titik dan ukuran yang ditampilkan setiap editor itu, apa pun urutan replika mendengarnya, dan seretan, geseran, atau zoom yang dikirimkan transport dua kali tidak menggerakkan apa pun dua kali.
Dengan Viewport tidak terkunci, replika menyimpan titik asal dan tingkat zoom masing-masing dari penulisan dengan versi terbesar, tempat editor yang membuatnya berada.
Zoom juga menggeser titik asal, sehingga geseran dan zoom yang dibuat dua editor pada saat yang sama dapat disimpan sebagai titik asal satu editor dengan tingkat zoom editor lainnya.
Sebelum 5.1.0, replika menambahkan langkah geser dan zoom setiap editor ke satu area pandang.

Jarak yang dikirim editor sebelum 5.1.0 untuk seretan, geseran, atau zoom (table.move, memo.move, tableGroup.move, settings.streamScrollTo, dan settings.streamZoomLevel) tetap ditambahkan ke apa yang dipegang replika, di luar versi.
Perubahan warna tetap tiba tanpa versi: replika, seperti setiap editor, menandainya dengan versi miliknya sendiri dan mempertahankan warna yang terakhir didengarnya, sehingga dua perubahan warna pada satu tabel, memo, atau grup tabel yang dibuat pada saat yang sama dapat disimpan berbeda dari apa yang ditampilkan editor.
Replika sebelum 5.1.0 menerapkan titik dan ukuran sesuai urutan kedatangannya, sehingga dapat menyimpan sebuah tabel di tempat yang berbeda dari tempat editor 5.1.0 menampilkannya.
Jaga setiap editor dalam sesi, dan replika, tetap di 5.1.0 atau yang lebih baru agar edit yang dibuat pada saat yang sama berakhir sama, kecuali pengecualian yang tercantum di Pengeditan pada saat yang sama.

Sejak 5.1.0, editor mengirim perubahan bahasa Generator Kode, konvensi penamaan, atau tipe tanda kutip hanya selama penguncian pengaturan itu nonaktif, ditandai shared: true di payload-nya, dan replika menerapkan setiap perubahan yang bertanda itu, seperti yang dilakukan editor; lihat Pengeditan kolaboratif.
Replika menerapkan perubahan tanpa tanda, yang dikirim editor sebelum 5.1.0 apa pun penguncian miliknya, hanya selama pengaturan itu tidak terkunci di sisinya, dan membuangnya selama pengaturan itu terkunci (lihat on@change).

Sejak 4.0.0, kedua metode juga menerapkan editor.mergeLWW, yang membawa register kolaborasi yang dikirim sebuah editor sebagai jawaban saat editor lain bergabung ke sesi, sehingga replika menentukan hasil perubahan serentak dengan cara yang sama seperti editor.
Aksi ini tidak mengubah satu byte pun dari value dan tidak memicu change.
settings.changeIgnoreSaveSettings, yang mungkin masih dikirim oleh editor yang dirilis sebelum 4.0.0, dipertahankan tetapi tidak mengubah apa pun: aksi ini memicu change dengan changed bernilai false.

destroy​

Menghancurkan instans replicationStore sepenuhnya.

replicationStore.destroy();

Setelah itu, store berhenti memancarkan change dan mengabaikan pengiriman berikutnya.
Dokumen membeku pada nilai terakhirnya alih-alih memunculkan kesalahan.
Buat store baru untuk memulai lagi.