fresh

はじめに Fresh v2.3がリリースされました。 この記事では主な変更点などについて解説します。 View Transition API View Transition APIのサポートが行われています (#3708) Partialの仕組みと統合されており、f-client-navによってクライアントナビゲーションが有効化されている要素に対してf-view-transitionを指定することで、Partialによる画面遷移に対してdocument.startViewTransition()が自動で適用されます。 もしブラウザーがView Transition APIをサポートしていない場合は、今まで通り通常のPartialによる画面遷移にフォールバックされます。 不要なJavaScript依存の排除 (Zero JavaScript by Default) アプリケーションがIsland及びPartialのどちらにも依存していない場合、本番ビルドがJavaScriptコードへ依存しないように改善されています (#3696) これによりFresh v1の頃と同様に、必要でなければJavaScriptコードがブラウザーに送信されなくなります。 WebSocketサポート FreshにWebSocketの公式サポートが追加されています (#3774) App#ws()メソッドが追加されており、WebSocket用のエンドポイントを定義することができます。またContext#upgrade()メソッドも追加されており、より柔軟にWebSocket向けのエンドポイントを実装することも可能です。 Islandに対するTemporalのサポート Islandコンポーネントのpropsに対するTemporal関連のオブジェクトの指定がサポートされています (#3701) なおTemporal APIについてはDeno v2.7にて安定化されています。 ipFilter()ミドルウェア @fresh/coreパッケージにipFilter()が追加されています (#3035) @std/net/unstable-ipのmatchSubnets()をベースに実装されており、指定されたCIDR表記に基づいてアクセス制限を掛けることができます。 csp() - リクエストごとのnonceの生成がサポート csp()ミドルウェアにuseNonceオプションが追加されています (#3709) このオプションにtrueが設定された場合、FreshはSSRごとに一意なnonceを生成し、各種インライン<script>や<style>に設定した上で、Content-Security-Policyヘッダーの各種ディレクティブに対してunsafe-inlineではなくnonce-<nonce>を設定してくれます。 trustProxyオプション AppにtrustProxyオプションが追加されています (#3757) このオプションにtrue が指定されると、ContextオブジェクトのurlプロパティーがX-Forwarded-Proto及びX-Forwarded-Hostヘッダーを考慮して設定されます。 複数静的ディレクトリのサポート staticDirオプションで配列の指定がサポートされています (#3759) Viteプラグイン (@fresh/plugin-vite) においてstaticDirオプションで配列が指定された場合、最初の要素 (ディレクトリ) がViteのpublicDirオプションに指定され、それ以外はFreshの開発サーバーから配信されるようです。 フォームに対する_freshIndicatorのサポート Partialが適用されたformまたはbutton[type=submit]要素に対して、ref経由で_freshIndicator属性にSignalを設定しておくことで、該当のフォームがsubmitされる際に_freshIndicatorに設定されたSignalが自動的にtrueに更新されます (#3753)。これにより該当のSignalの値を元にローディングのアニメーションを表示することなどが可能です。 @fresh/init - deno createのサポート @fresh/initパッケージでdeno createコマンドによるプロジェクトの作成がサポートされています (#3706, #3746) これによりdeno create jsr@fresh/initコマンドでプロジェクトが作成できます。...

Deno v2.6.7 Deno v2.6.7がリリースされています。 JSR - @jsrスコープの取り扱いの変更 @jsrスコープのnpmパッケージがJSRから取得されるよう挙動が変更されています (#31925)。具体的には、以下を実行すると@uki00a/deno-json-lintがインストールされます。 # `npm:@jsr/*` は registry.npmjs.org からダウンロードされます $ deno install npm:@jsr/uki00a__deno-json-lint $ cat deno.json | jq '.imports["@jsr/uki00a__deno-json-lint"]' "npm:@jsr/uki00a__deno-json-lint@^0.4.0" デフォルトではhttps://npm.jsr.io からパッケージがダウンロードされますが、 JSR_NPM_URL環境変数または.npmrcによって設定変更が可能です。 Deno.cron() - 外部サーバーへのタスク管理の移譲がサポート (DENO_UNSTABLE_CRON_SOCK) Deno.cron()によるジョブ管理をソケットを介して外部サーバーへ移譲する機能が実装されています (#31952) この機能はDENO_UNSTABLE_CRON_SOCKにソケットへのURLを指定することで有効化されます (例: unix:/path/to/cron.sock)。指定されたソケットとの間でJSON形式のメッセージを交換し合うことでジョブの管理が行われます。 DenoプロセスでDeno.cron()が呼ばれると、ソケットに対してタスクの登録用メッセージが送信されます ({ "kind":"register", "crons": [{ "name": "<task-name>", "schedule": "<cron-expression>" }] }) サーバーはソケットに対してタスクの実行を指示するメッセージ ({ "kind": "invoke" }) を書き込むことで、そのメッセージを受信したDenoプロセスで指定されたタスクが実行されます。 Denoプロセスでタスクの実行が完了すると、ソケットに対して実行完了メッセージが書き込まれます ({ "kind": "result", "name": "<task-name>", "success": true }) おそらく、主にDeno Deploy向けの機能であると推測されますが、上記メッセージを処理するサーバー実装を用意することで、独自のジョブ管理の仕組みが実装できそうです。 Node.js互換性の改善 node:test 下記のモック関連APIが実装されています (#31954)...

Denoの直近のアップデート まだリリースは行われていませんが、直近でいくつか新機能がマージされているため紹介いたします。 --ignore-envオプションが追加 Deno--ignore-envオプションが実装されています。 feat: add --ignore-env=... #31187 例えば以下のようなスクリプトがあったとします: // main.js console.info(Deno.env.get("HOME")); console.info(Deno.env.get("DENO_DIR")); このスクリプトを--ignore-env=HOMEを指定して実行すると、以下のように出力されます: $ deno run --allow-env --ignore-env=HOME main.js undefined /home/uki00a/.cache/deno Deno.env.toObject()を実行した場合、--ignore-envで指定された環境変数が返却結果から除外されます。 この機能はdeno.jsonにおけるパーミッションセット (--permission-set)においてもサポートされています。 { "permissions": { "default": { "env": { "allow": true, "ignore": ["HOME"] } } } } deno audit --socket deno auditコマンドに--socketオプションを追加するPRがマージされています: feat(unstable): add socket.dev integration for deno audit #31106 このオプションを指定すると、@socketsecurity/bun-security-scannerでも使用されているfirewall-api.socket.devエンドポイントを使用してパッケージの検査が行われます。 $ deno audit --socket No known vulnerabilities found Socket....

Deno v2.5.5 & Deno v2.5.6 Deno v2.5.5とDeno v2.5.6がリリースされています。 typescript-goの実験的サポート (--unstable-tsgo) typescript-goの実験的サポートが行われています (#30920) deno checkコマンドに--unstable-tsgoを指定すると、typescript-goを使用した型チェックが実施されます。 $ deno check --unstable-tsgo mod.ts minimumDependencyAge あるパッケージの最新バージョンがインストールされるまでの猶予期間の設定がサポートされています (#30752, #31007, #31031) deno.jsonのminimumDependencyAgeフィールドまたは--minimum-dependency-ageオプションによって猶予期間を指定可能です。 { "minimumDependencyAge": { // 公開されてから最低でも1日 (=1440分) 以上経過しているバージョンのみをインストールします "age": 1440, // `minimumDependencyAge`の適用を除外したいパッケージを指定します "exclude": ["npm:@my-company/some-package"] } } $ deno install --minimum-dependency-age=1440 npm:preact deno audit deno auditコマンドが実装されています (#30966) npmレジストリの Full Audit エンドポイント (/-/npm/v1/security/audits) を利用したパッケージの検査を行うことができます。 $ deno audit No known vulnerabilities found $ deno audit --level=critical No known vulnerabilities found まだマージはされていませんが、deno auditコマンドに--socketオプションを実装するPRが作成されています。...

Denoの直近のアップデート typescript-goのサポートがマージ (--unstable-tsgo) 以前に紹介した、deno checkコマンドでtypescript-goをサポートするPRがマージされています (#30920)。まだリリースはされていませんが、canary バージョンで動作を試すことが可能です。 deno checkを実行する際に--unstable-tsgoオプションを指定することで、まずdenoland/typescript-goが${DENO_DIR}/dlへダウンロードされます。 その後、--apiオプションを指定して起動されたtsgoとプロセス間で通信することによって型チェックが実行されているようです (microsoft/typescript-go/cmd/tsgo/main.go#L19-L20) $ deno check --unstable-tsgo mod.ts 詳細はdenoland/deno/docs/tsgo.mdにて解説されています。 deno.jsonでのminimumDependencyAgeのサポート 先週に紹介した、deno.jsonでのminimumDependencyAgeのサポートがマージされています (#31007) さらに、特定のパッケージを対象から除外できるよう、minimumDependencyAgeにおいてオブジェクト形式での設定がサポートされています: feat(unstable): ability to exclude packages from minimum dependency age constraint #31031 minimumDependencyAge.ageフィールドに猶予期間、minimumDependencyAge.excludeフィールドに適用対象から除外したいパッケージを指定できます。 { "minimumDependencyAge": { "age": "PT5H", "exclude": ["npm:preact"] } } deno auditコマンド 以前に紹介した、deno auditコマンドの実装がマージされています。 feat(unstable): add deno audit subcommand #30966 npmレジストリの Full Audit エンドポイント (/-/npm/v1/security/audits) を利用したパッケージの検査がサポートされています。 内部的には firewall-api.socket.dev を使用した検証の実装も含まれているようですが、現時点ではまだユーザーから利用するための手段は提供されていなさそうです。 ecosystem_compat_test 内部的な変更ではありますが、日次でnpm/ yarn/pnpmをDenoで実行し、互換性を検証する仕組みが導入されています:...

Deno v2.5.1 Deno v2.5.1がリリースされています。 Deno API Deno.HttpClient WebSocketでclientオプション (Deno.HttpClient) がサポートされています (#30692)。 これにより、プロキシーの利用やallowHostオプションによりHostヘッダーのカスタマイズなどが可能です。この改善にあわせてHTTP_PROXYなどのプロキシー関連の環境変数がWebSocketにも適用されるよう改善されています。 また、Deno.createHttpClient()でproxy.transport: "tcp"がサポートされています (#30700) Deno.serve() DENO_SERVE_ADDRESSにduplicate,<address>形式のアドレスが指定された際に、signalやonErrorオプションも引き継がれるよう改善されています (#30680) Deno.bundle() --unstable-bundleなしでDeno.bundle()を使用した際に--unstable-bundleの指定が促されるように改善されています (#30682) deno init macOSでdeno init --npmが動作しなくなっていた問題が修正されています (#30730) deno lsp deno.cacheOnSaveによる依存関係のキャッシュ時はdeno.lockを更新しないよう挙動が変更されています (#30733) deno check SvelteKit における$app/environmentなど、bare specifier 形式の ambient module でエラーが発生しないよう挙動が変更されています (#30690) node:fs 以下の改善が実施されています。 Windowsでfchmod()がサポートされています (#30704) glob()のcwd引数でURLオブジェクトの指定がサポートされています (#30705) callback引数を指定せずにclose()を呼ぶとエラーが発生する問題が修正されています (#30720) readlink()のpath引数でBufferの指定がサポートされています (#30691) node:process process.envにおいて空文字列などの falsy な値を持つ環境変数がObject.keys()などで返却されない問題が修正されています (#30708) Fresh v2.1.0 Fresh v2.1.0のリリースが実施されています。 @fresh/core@2.1.0 @fresh/core@2.1.0がリリースされています。 CSPミドルウェア csp()ミドルウェアが追加されています (#3421) 指定されたオプションに基づいてContent-Security-Policyヘッダーを設定してくれます。 複数ミドルウェアのサポート Fresh v1 でサポートされていた_middleware....

Deno v2.5 Deno v2.5.0がリリースされました。 以下のページに変更内容をまとめているため、よろしければ参照ください: Deno v2.5 Fresh v2 が正式にリリース Fresh v2 (@fresh/core@2.0.0) のリリースについて 2025/09/10 に Fresh v2 (@fresh/core@2.0.0)が正式にリリースされました。 2.0.0 chore: release 2.0.0 (#3371) 注意点として、Viteプラグイン (@fresh/plugin-vite)やTailwind CSSプラグイン (@fresh/plugin-tailwind)についてはFreshの本体である@fresh/coreパッケージとは独立してバージョニングされており、これらのパッケージの現時点での最新メジャーバージョンはv2ではなくv1です。 その後のアップデート Fresh v2 の正式リリース後も引き続き開発が進められています。 @fresh/plugin-vite@1.0.2では.envの読み込みがサポートされています (#3416)。.envに加えて、環境に応じて追加で以下のファイルも読み込まれるようです: .env.local .env.{development,production} .env.{development,production}.local また、Fresh v2 アプリケーションをdeno compileできるよう、ビルド後に_fresh/compiled-entry.jsというファイルを生成する改善も実施されています (#3410)

Deno v2.5 向けの機能の追加について Deno v2.5 向けに直近でマージされた内容について紹介します (⚠️まだ正式にはリリースされていないため、今後、APIの使い方に変更が発生する可能性があります) Deno.bundle()APIが追加 deno bundleコマンドの機能をプログラムから動的に利用するために、Deno.bundle()というAPIが追加されています。 feat(bundle): runtime API for deno bundle #29949 Deno.bundle()を利用するためには--unstable-bundleによって明示的に有効化が必要です: const result = await Deno.bundle({ entrypoints: ["./mod.ts"], platform: "deno", }); console.assert(result.success); const [outputFile] = result.outputFiles; const bundledCode = outputFile.text(); console.assert(typeof bundledCode === "string"); outputPathやoutputDirオプションを指定することで、バンドル結果がファイルシステムへ書き込まれます (--allow-writeの指定は不要なようです): const result = await Deno.bundle({ entrypoints: ["./mod.ts"], platform: "browser", minify: true, sourcemap: "external", outputDir: "dist", }); console.assert(result.success); まだマージはされていませんが、現在、プラグイン (pluginsオプション) のサポートに関する実装も進められているようです:...

Deno v2.5 向けの機能の追加について Deno 2.5.0 向けのマイルストーンに関連して、新機能を実装するためのPRがいくつか作成されているため、紹介します。 Deno.testへのbefore*/after*フックのサポート まだマージはされていませんが、Deno.test配下に Vitest や Jest ライクなbefore*/after*APIをサポートするPRが作成されています: feat(test): Add setup and teardown APIs to Deno.test API #30504 af75749のコミットの時点では、以下の4つのフックが実装されています: Deno.test.beforeAll() Deno.test.afterAll() Deno.test.beforeEach() Deno.test.afterEach() Deno.ChildProcess.{stdout,stderr}へのResponseライクな問い合わせメソッドの追加 Deno.ChildProcessのstdout及びstderrプロパティーにおいて、Responseライクに出力内容を取得するためのユーティティーメソッドを追加するPRが作成されています: feat(ext/process): add collector utilities to ChildProcess.stdout & ChildProcess.stderr #30552 const command = new Deno.Command(Deno.execPath(), { args: ["json_reference"], stdout: "piped", }).spawn(); const json = await command.stdout.json(); 852714eのコミットの時点においては、以下の4つのメソッドが実装されています: arrayBuffer bytes json text Fresh v2 関連のアップデート @fresh/init@2....

deno.jsonでのパーミッションセットの定義について まだDraft状態ですが、deno.jsonでのパーミッションセットの定義をサポートするPRが作成されています。 feat: permissions in the config file #30330 以前に導入が検討されていた頃の仕様と比較して、以下のような変更点がありそうです (まだマージはされていないため、今後、仕様が変わる可能性があります): deno.jsonにおいてパーミッションセットの一覧を定義するためのフィールド名がpermissionSetsからpermissionsに変わっています。 bench/compile/testという名前のパーミッションセットは特別扱いされ、パーミッションセットが省略された状態で-P(--permission-set)オプションが指定された際に、それぞれdeno bench/deno compile/deno testの実行時に自動で適用されるようです (cli/args/mod.rs#L1172-L1188) deno.jsonで複数のパーミッションセットを定義することができます: { "permissions": { "default": { "read": ["data"], "net": true }, "tool": { "read": ["src"], "write": ["generated"] } } } -Pまたは--permission-setによって定義されたパーミッションセットを適用できます: # `default`パーミッションセットを適用 $ deno run -P main.ts # `tool`パーミッションセットを適用 $ deno run --permission-set=tool tools/codegen.ts FreshのViteプラグインが公開 (@fresh/plugin-vite) 直近で開発されていたFreshのViteプラグインが正式にマージされています:...