claude plugin test. Tes menaikkan peristiwa yang ditangani hook Anda dan memeriksa apa yang dilakukan hook, sehingga Anda menangkap masalah sebelum mencapai sesi. Contoh pertama menguji mod dari Buat mod.
Tulis tes
Tes memuat mod Anda, mengirim peristiwa melalui hook dengan cara Claude Code akan melakukannya, dan memeriksa apa yang dilakukan hook, tanpa sesi, masuk, atau jaringan. Anda menjalankan tes dari shell Anda denganclaude plugin test, dan setiap file tes mengimpor test kit, perpustakaan tes dalam modul claude-code/testing.
Berikan setiap file tes nama yang diakhiri dengan .test.ts, seperti first-mod.test.ts, dan simpan di mana saja dalam direktori plugin. Setiap file tes memerlukan setidaknya satu test(), atau jalankan gagal dengan declares no test(): nothing ran. File tes dapat mengimpor file mod Anda sendiri dan pembantu .ts saudara, sehingga Anda dapat menguji unit fungsi biasa, seperti aturan permainan, tanpa kit.
Tes ini menaikkan dua panggilan alat, menjalankan perintah /tally dari Buat mod, dan memeriksa bahwa balasan menghitung keduanya. Baris pertamanya adalah stub, yang menjawab panggilan alat di tempat Claude Code. Simpan sebagai first-mod/tests/first-mod.test.ts:
first-mod/tests/first-mod.test.ts
first-mod:
$.tool.call melalui hook tool.call mod, yang menambah satu ke hitungannya dan meneruskan panggilan ke stub. Tidak ada ls yang berjalan dan tidak ada file yang dibaca. $.command.run kemudian pergi ke hook command.run mod, dan answer adalah objek yang dikembalikan hook.
Perintah keluar dengan status 1 ketika tes gagal, sehingga berfungsi di CI. Jika mod Anda sendiri tidak dapat dimuat di shell yang menjalankannya, itu mencetak baris yang dimulai dengan claude plugin test: hooks modules are turned off dengan alasannya, dan keluar dengan status 1.
Stub apa yang akan dijawab Claude Code
Tidak ada model, toko, atau alat yang berjalan dalam tes, jadi di mana pun mod Anda mengharapkan Claude Code untuk menjawab, tes menyediakan jawaban dengan stub. Fungsi tes menerima dua argumen untuk itu:$:$tes sendiri, yang berdiri di mana Claude Code berada. Ini bukan mods API yang diterima hook. Setiap metodenya menaikkan peristiwa dengan nama yang sama, mengirimnya melalui hook mod Anda, dan menyelesaikan ke hasil:$.tool.call({ tool: 'Bash', command: 'ls' })menaikkantool.call.$.command.run,$.prompt.submit,$.session.start, dan$.turn.completebekerja dengan cara yang sama, dan$.classic.Stopdan metode$.classiclainnya menaikkan peristiwa hook pengaturan. Tes tidak dapat menaikkan panggilan mods API sepertiui.closesecara langsung. Picu melalui mod Anda, misalnya dengan menekan tombol yang menutup panel.on: panggil untuk mendaftarkan stub, yang merupakan hook yang menjawab di tempat Claude Code. Beri nama stub untuk panggilan mods API tanpa$., jadi stub yang didaftarkan sebagaistore.getmenjawab$.store.getmod Anda. Ketika mod Anda memanggil$.model.completeatau$.store.get, stub menyediakan jawaban.
grader, dan menangani perintah /grade yang mengirim kalimat ke model dan melaporkan apakah balasan dimulai dengan PASS. File hanya menyimpan hook yang diuji, jadi mod juga memerlukan plugin.json dan hooks.json, seperti dalam Buat mod. Untuk mengetik /grade dalam sesi, mod juga harus mendaftarkan perintah:
grader/hooks/register.js
grader/tests/grader.test.ts
reply hook adalah objek di bawah value, yang text dimulai dengan PASS. Untuk memeriksa cabang lain, tambahkan tes kedua yang stub mengembalikan text yang dimulai dengan FAIL, dan harapkan Try again.
Stub untuk panggilan mods API mengembalikan objek dengan bidang value, yang menyimpan apa yang dipanggil dalam mod Anda: { value: 7 } membuat $.store.get menyelesaikan ke 7. Stub untuk salah satu peristiwa Claude Code, seperti turn.step atau tool.call, mengembalikan hasil peristiwa itu sendiri, seperti { result: 'ok' }. $.session.send dan $.prompt.fill mengambil hasil peristiwa juga, seperti yang ditunjukkan tabel. Lihat apa yang dikembalikan stub menunjukkan bentuk mana yang diambil setiap nama umum. Dua kesalahan berarti stub salah atau hilang. Output tes yang gagal mencakup blok yang dikepalai the engine reported:, dan setiap kesalahan muncul di sana:
returned neither { value } nor { deny }: stub untuk panggilan mods API mengembalikan nilai telanjangno implementation fordiikuti oleh nama: mod Anda membuat panggilan itu dan tidak ada stub yang menjawabnya
mock.clock(on) menjawab $.clock, mock.store(on, { count: 7 }) menjawab $.store dari toko yang dimulai dengan entri tersebut, dan mock.env(on, { CI: 'true' }) menjawab $.env.get dari variabel tersebut. mock.clock mengembalikan jam mock yang tes Anda maju, sehingga tes timer tidak menunggu. mock.store mengembalikan tidak ada, jadi untuk memeriksa apa yang disimpan mod Anda, tulis dua stub store sendiri seperti tes gambar lakukan.
Ikuti aturan test kit
Test kit memiliki beberapa aturan sendiri, dan melanggar satu menghasilkan kesalahan yang ditemui penulis tes baru terlebih dahulu:-
Daftarkan setiap stub sebelum panggilan pertama tes pada
$. Memanggilonsetelah itu melempar kesalahan sepertion("ui.render") after the test first called $. -
session.starttidak berjalan dengan sendirinya. Setiap tes dimulai dengan modul Anda dimuat segar dan tidak ada hook yang dipanggil, jadi variabel tingkat modul menyimpan nilai awal mereka. Jika hook bergantung pada apa yang ditetapkansession.start, naikkan terlebih dahulu:Stub kedua menjawab panggilan$.command.registeryang dibuat hooksession.startseperti tutorial. Tanpa itu, panggilan itu menolak denganno implementation for command.registerdan kit melewati hook Anda, jadi tidak ada yang setelah panggilan dalam hook yang berjalan. Tes tidak gagal pada titik itu. Hook yang dilewati hanya tercantum di bawahthe engine reported:jika pemeriksaan nanti gagal. -
Hook yang mengembalikan
next(e)memerlukan stub untuk menjawab. Ketika hookui.renderAnda mengembalikannext(e), misalnya untuk tidak menggambar apa pun saat Claude menganggur, memasangnya gagal denganno implementation for ui.render. Daftarkan stub yang mengembalikan elemen sebagai data biasa:Dengan stub terdaftar, pemasangan berhasil, danui.find({ type: 'Text' })mengembalikan elemen itu setiap kali hook Anda mengembalikannext(e). -
Stub untuk
turn.stepadalah generator async, dan tes membaca aliran ke akhirnya untuk mendapatkan hasil:Ketika loop berakhir,resultadalah objek yang dikembalikan stub, setelah hookturn.stepAnda memiliki kesempatan untuk mengubahnya. Di siniresult.answeradalah'ok'. -
Naikkan panggilan alat dengan nama alat dan argumen sebagai bidang, seperti
await $.tool.call({ tool: 'Bash', command: 'ls' }), dan daftarkan stubtool.callyang mengembalikan{ result }.
Lihat apa yang dikembalikan stub
Setiap panggilan mods API yang dibuat mod Anda dalam tes memerlukan stub yang menjawab di tempat Claude Code, kecuali beberapa yang dijawab kit sendiri: panggilan$.ui.invalidate dan $.state. Untuk panggilan $.clock, gunakan mock.clock(on), atau $.clock.now() mod Anda gagal dengan no implementation for clock.now.
Tabel ini mencantumkan yang paling sering digunakan mod. Kolom pertama adalah panggilan yang dibuat mod Anda atau peristiwa yang dilewatkan dengan next(e). Kolom kedua adalah fungsi untuk diteruskan ke on di bawah nama itu, jadi baris $.store.get menjadi on('store.get', ($, e) => ({ value: saved.get(e.key) })). '...' dalam stub menandai teks untuk Anda isi:
expect memiliki asersi toBe, toEqual, toMatch, toMatchObject, toContain, toBeDefined, toBeUndefined, dan toThrow, dan .not sebelum salah satu dari mereka.
Uji coba timer
Mod yang menjalankan pekerjaan pada timer memerlukan jam yang dikontrol tes, sehingga tes dapat memajukan waktu alih-alih menunggu.const clock = mock.clock(on) mengembalikan jam mock yang dimulai pada 0 dan bergerak hanya ketika tes Anda memindahkannya. Untuk memulai pada waktu lain, teruskan dalam milidetik, seperti dalam mock.clock(on, { now: 5000 }). Jam memiliki metode ini:
Hook ini milik mod bernama
countdown, dan menangani perintah /countdown yang mengambil jumlah detik, memulai timer $.clock.every satu detik, dan menunjukkan toast pada nol. Seperti dengan grader, file hanya menyimpan hook yang diuji dan tidak mendaftarkan perintah:
countdown/hooks/register.js
/countdown 3 dan memajukan jam mock, sehingga memeriksa tiga detik perilaku tanpa menunggu tiga detik:
countdown/tests/countdown.test.ts
expect pertama menunjukkan bahwa toast tidak datang lebih awal, dan yang kedua menunjukkan bahwa itu datang sekali. Setiap advance menyelesaikan setelah timer yang jatuh tempo telah berjalan, sehingga pemeriksaan pada baris berikutnya melihat efeknya.
Uji coba gambar
Tes dapat menggambar salah satu situs render mod Anda, kemudian menekan, mengetik ke, dan menemukan elemen yang digambarnya.$.ui.mount menggambar situs melalui hook ui.render mod Anda dan mengembalikan handle dengan metode untuk masing-masing. Untuk mencakup beberapa aplikasi dalam satu tes, atur surface ke aplikasi untuk digambar. Tes ini membuka panel dari Bangun panel dengan tab, beralih tab, menekan tombol, dan memeriksa hitungan di terminal dan aplikasi Desktop:
hello-tabs/tests/hello-tabs.test.ts
claude plugin test dari direktori hello-tabs. Tes lulus ketika kedua aplikasi menggambar garis hitungan dan mod telah menyimpan 2. Hitungan dibawa dari aplikasi pertama ke yang kedua karena kedua pemasangan menggunakan modul yang dimuat sama.
Handle yang dikembalikan $.ui.mount memiliki metode ini, yang mengatasi elemen berdasarkan key yang Anda berikan:
Setiap metode menyelesaikan setelah handler Anda selesai, sehingga Anda dapat memeriksa hasil pada baris berikutnya. Atur
props ke apa yang akan dilewatkan Claude Code untuk situs itu. Tabel situs render mencantumkan props setiap situs, dan tipe untuk build Anda memiliki tipe mereka.
Tes gambar memeriksa pohon yang dikembalikan hook Anda dan apakah itu valid untuk aplikasi itu. Itu tidak memeriksa bagaimana aplikasi melukisnya, jadi lihat tata letak baru dalam sesi nyata juga.
Uji coba gambar setelah /clear
Setiap tes dimulai dengan setiap nilai $.state pada default-nya, yang merupakan cara /clear meninggalkannya. Untuk menguji apa yang dilakukan mod Anda selanjutnya, lewati session.start, naikkan classic.SessionStart dengan source: 'clear', dan periksa apa yang digambar mod Anda.
Tes ini memeriksa modul dari Muat nilai yang disimpan lagi setelah /clear. Tambahkan ke file dari Uji coba gambar, di mana PANE didefinisikan. Tes pertama file itu mengharapkan tombol untuk menyimpan hitungan, seperti tombol dalam Simpan dari lebih dari satu sesi:
hello-tabs/tests/hello-tabs.test.ts
classic.SessionStart Anda telah menyalin 7 yang disimpan ke $.state sebelum panel menggambar. Tanpa hook itu dalam modul Anda, panel menggambar Count: 0, find mengembalikan undefined, dan tes gagal di toBeDefined.
Uji coba mod yang menilai mod lain
Mod yang tercantum organisasi Anda dalamprependPlugins dapat menolak mod lain sebelum dimuat. Untuk menguji satu, atur tier mod Anda dan berikan tes mod kedua untuk diterima atau ditolak:
tier: panggil sekali di bagian atas file tes, seperti dalamtier('prepend'), untuk memuat mod Anda sebagaiprepend,append, ataubuiltin, tempatnya dalam urutan mod berjalan. Tanpa itu, mod Anda memuat sebagaiuser.plugins: teruskantestobjek opsi di depan badan tes. Arraypluginsmenyimpan mod yang Anda tulis inline, masing-masing dengannamedan fungsiregister. Untuk memuat satu di tempat lain selainuser, tambahkantierke itu.
acme-guard/tests/guard.test.ts
claude plugin test dari direktori acme-guard. Kedua tes lulus dengan mod kebijakan seperti yang ditunjukkan halaman admin.
Kit memuat setiap mod pada panggilan pertama tes pada $. Ketika mod Anda menolak satu, panggilan itu melempar, dan pesan menamai mod yang ditolak, mod yang menolaknya, dan alasan Anda. Dalam tes kedua tidak ada yang ditolak, jadi reader menjawab panggilan alat sebelum mencapai stub.
Langkah berikutnya
- Troubleshoot mod: cari tahu mengapa mod tidak melakukan apa pun dalam sesi
- Referensi mods: setiap peristiwa input dan hasil, untuk menulis stub