Browser Extensions Development (Chrome & Edge) · Pelajaran

Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest

Tambahkan dan perbarui aturan saat berjalan, kelola ID serta prioritas aturan, dan amati permintaan yang cocok untuk penelusuran kesalahan.

Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest adalah pelajaran Browser Extensions Development (Chrome & Edge) gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Browser Extensions Development (Chrome & Edge), dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Browser Extensions Development (Chrome & Edge) mencakup 4 pelajaran total.

Bagian dari pelajaran ini belum diterjemahkan dan ditampilkan dalam bahasa Inggris.

Static vs Dynamic Rules

declarativeNetRequest supports two rule kinds. Static rules ship in JSON files in the manifest. Dynamic rules are added at runtime and persist across restarts.

Dynamic rules let your extension adapt to user choices without an update.

Declaring the Permission

You need the declarativeNetRequest permission. For dynamic rules at runtime, that is all you require.

{
  "permissions": ["declarativeNetRequest"]
}

The Shape of a Rule

Each rule has an id, a priority, an action, and a condition. The condition decides which requests match.

{
  "id": 1,
  "priority": 1,
  "action": { "type": "block" },
  "condition": { "urlFilter": "ads.example.com" }
}

Adding Dynamic Rules

Use updateDynamicRules to add rules. Pass them in the addRules array.

chrome.declarativeNetRequest.updateDynamicRules({
  addRules: [{
    id: 1, priority: 1,
    action: { type: 'block' },
    condition: { urlFilter: 'tracker.com', resourceTypes: ['script'] }
  }]
})

Removing Rules by ID

The same call removes rules by listing their IDs in removeRuleIds. Adds and removes can happen together.

chrome.declarativeNetRequest.updateDynamicRules({
  removeRuleIds: [1]
})

Unique Rule IDs

Every dynamic rule needs a unique numeric id. Reusing an existing ID without removing it first causes an error.

const existing = await chrome.declarativeNetRequest.getDynamicRules()
const nextId = Math.max(0, ...existing.map(r => r.id)) + 1

Priorities Resolve Conflicts

When multiple rules match, priority decides which wins. Higher priority takes precedence; allow rules can override block rules at the same level.

{ "id": 2, "priority": 2, "action": { "type": "allow" }, "condition": { "urlFilter": "safe.com" } }

Session Rules

If you want rules that vanish when the browser closes, use updateSessionRules instead. They never persist to disk.

chrome.declarativeNetRequest.updateSessionRules({
  addRules: [tempRule]
})

Observing Matched Requests

For debugging, enable the feedback permission and listen to onRuleMatchedDebug to see which rule fired for each request.

chrome.declarativeNetRequest.onRuleMatchedDebug.addListener((info) => {
  console.log('Matched rule ' + info.rule.ruleId)
})

Inspecting Current Rules

Call getDynamicRules to list everything currently active. This is essential when a rule misbehaves and you need to confirm what is installed.

const rules = await chrome.declarativeNetRequest.getDynamicRules()
console.log(rules.length + ' active rules')

Staying Within Limits

There is a cap on the number of dynamic rules. Audit and remove stale rules instead of piling on, and group conditions where possible to stay efficient.

Quick Check

Test your dynamic rules knowledge.

Recap

You learned dynamic request rules:

Add and remove with updateDynamicRules
Keep IDs unique and use priority for conflicts
Use session rules for temporary state
Debug with onRuleMatchedDebug and getDynamicRules
Respect rule count limits

Runtime rules let your extension adapt without shipping an update.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest” gratis?

Ya — teks lengkap “Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Browser Extensions Development (Chrome & Edge), upgrade ke CoddyKit PRO. Kursus Browser Extensions Development (Chrome & Edge) mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest”?

Tambahkan dan perbarui aturan saat berjalan, kelola ID serta prioritas aturan, dan amati permintaan yang cocok untuk penelusuran kesalahan. Kamu berlatih Browser Extensions Development (Chrome & Edge) dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Browser Extensions Development (Chrome & Edge)?

Tidak diperlukan pengalaman sebelumnya. Browser Extensions Development (Chrome & Edge) di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Browser Extensions Development (Chrome & Edge) ini?

Ya. Setiap pelajaran Browser Extensions Development (Chrome & Edge) menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

Memblokir Permintaan Jaringan
Mengubah Header Permintaan
Mengalihkan dan Menulis Ulang URL
Aturan Dinamis dan Penelusuran Kesalahan declarativeNetRequest

← Kembali ke Browser Extensions Development (Chrome & Edge)