MarkdownやAsciidoc中に書いたJavaScriptのサンプルコードをdoctestするツールを作った

技術書、ブログ、READMEを書いてていて、文章中に出てくるコードブロックのコードをテストしたいことがあると思います。 そのサンプルコードが本当に動いてるのか不安になることがあるからです。 power-doctestは、そのコードブロック中のコードにコメントを入れるだけでテスト可能にするツール群です。 power-doctestの例 具体的な例から見ていきます。 次の例では、Markdownで説明とJavaScriptのコードブロックを書いています。 デフォルト引数を使って書くことで、このような挙動は起きなくなるため安全です。 デフォルト引数では、引数が渡されなかった場合のみデフォルト値が入ります。 ```js function addPrefix(text, prefix = "デフォルト:") { return prefix + text; } // falsyな値を渡してもデフォルト

[ko-ya-ma]

> “コードブロック中のコードにコメントを入れるだけでテスト可能にするツール群です”

[inamem9999]

なんかすげえ時代になったな

[akulog]

おもしろい " 次のように // => 評価結果 が assert に変換され、テストとして実行できます。"

[efcl]

MarkdownやAsciidocのコードブロック内のJavaScriptコードをdoctestするツールやライブラリについて。 コメントで式の期待する評価結果を書くと、assertに変換してテストできる。