Dokumen ini bertujuan untuk mengatasi kesulitan yang dialami pengguna dalam negeri dalam mempelajari FramerFramer karena kurangnya materi dalam bahasa Indonesia, dengan menerjemahkan konten dari blog resmi dan menambahkan informasi praktis. Semoga dapat memberikan manfaat bagi Anda yang menggunakan FramerFramer.

Apa itu kesalahan publikasi (Publish Error)?

Kesalahan publikasi terjadi ketika masalah muncul pada komponen atau halaman saat mendistribusikan situs, sehingga distribusi dihentikan.
Jika ada kesalahan publikasi, pemberitahuan toast “Failed to publish because there is an error on a page.” akan ditampilkan.
Dalam situasi ini, tombol Review akan terlihat, memungkinkan Anda memeriksa komponen mana yang bermasalah.

Penyebab umum yang sering terjadi

1. Batas waktu pembuatan komponen habis

   Saat FramerFramer menyusun halaman, ia memuat dan merakit komponen satu per satu. Jika ada komponen yang terlalu lambat atau berhenti, dan waktu habis, publikasi akan gagal.
   Sebagai contoh, di alat pemeriksa web (developer tools) Anda mungkin melihat pesan seperti ensureComponentsInLoader: Component loader not updated in time.

   Cara mengatasinya

   Silakan coba publikasikan kembali. Jika terus gagal, Anda perlu memperbaiki atau bahkan menghapus komponen yang bermasalah.

   
   

2. Komponen yang digunakan hilang (Kesalahan Hilang)

   Jika Anda menggunakan komponen yang dibuat sebelumnya, dan komponen tersebut telah dihapus, namanya diubah, atau file-nya tidak dimuat dengan benar, akan ada masalah. Di FramerFramer, komponen seperti itu akan ditampilkan sebagai kotak abu-abu di panel layer.
   Dengan menekan tombol Review, Anda dapat segera memeriksa bagian mana yang bermasalah.

   Cara mengatasinya

   Kotak abu-abu yang ditampilkan perlu Anda muat ulang atau buat baru untuk menggantikannya.

Apa itu kesalahan optimasi (Optimization Error)?

Di FramerFramer, untuk menampilkan situs lebih cepat, optimasi dilakukan dengan prapenggambaran (Pre-rendering) halaman di server. Namun, karena server bukanlah browser, informasi berikut tidak dapat diketahui.

• Cookie

• Ukuran jendela

• Bahasa

• Atau objek browser seperti window, document, navigator

Namun, jika komponen kode kustom atau Override yang Anda buat mencoba mengakses informasi tersebut, server tidak dapat menjalankannya dan akan muncul peringatan optimasi (Optimization Warning).

Status Optimasi

1. Telah Dioptimasi (Optimized)

2. Peringatan Optimasi (Optimization Warning)

3. Kegagalan Optimasi (Optimization Error)

Catatan: Anda dapat memeriksa status optimasi di Settings → Domains atau Settings → Versions.

Mengapa ini penting?

• Bahkan pada tingkat peringatan, beberapa halaman mungkin menunjukkan konten yang terlambat muncul atau terlihat kosong.

• Jika ada kesalahan, halaman terkait dapat terkena dampak pada SEO, Core Web Vitals, dan metrik kualitas lainnya.

Komponen kode yang harus diperhatikan

Penyebab paling umum dari kesalahan optimasi adalah komponen kode yang menggunakan API khusus browser seperti window, document, dan navigator. Karena server bukanlah lingkungan browser, nilai-nilai ini tidak ada.

Dalam situasi ini, gunakanlah rendering bersyarat atau

```js
if (typeof window !== "undefined") {
  // window가 있을 때만 실행되도록 처리
}
```

Refactor kode Anda sesuai dengan panduan FramerFramer agar sesuai dengan optimasi.
Catatan: Silakan lihat panduan detail di 'How to fix custom code optimization errors'.

Artikel ini merupakan adaptasi dari konten FramerFramer blog resmi ‘How to debug a publish or optimization warning’.