deno_std

Deno v1.46.0 Deno v1.46.0がリリースされています。 以下に内容をまとめたため、よろしければこちらを参照いただければと思います。 Deno v1.46 Deno v1.46.1 Deno v1.46.1がリリースされています。 URLPattern#exec Deno v1.46.0による変更の影響で、URLPattern#execの振る舞いが変わっていたため、元の挙動に戻されています (ただし、Deno v2.0がリリースされる際に再び、v1.46.0の挙動に戻される予定のようです) v1.46.0ではパターンにマッチするグループがない場合にgroups[key]にundefinedが設定されるように挙動が変わっていたため、Deno v1.45までの空文字列を設定する挙動に戻されています。 node:wasi node:wasiをimportやrequireなどで読み込めるようになりました (ただし、実装はまだ行われていません) DENO_AUTH_TOKENS DENO_AUTH_TOKENSにおいて、前後の空白文字がきちんと取り除かれるように挙動が改善されています std/wsの追加に関する提案 だいぶ前に削除されたstd/wsを再びdeno_stdに追加する提案が行われています。 proposal: bring back the ws module #5755 標準のWebSocketAPIには自動的な再接続機能が存在しないことや、socket.ioが提供するRoomなどの抽象化が提供されていないことなどが背景として挙げられています。

Denoの直近の変更について 先週に続けて、おそらく次のDeno v1.46でリリースされると思われる機能がいくつかマージされているため、気になったものについて紹介いたします。 ⚠️正式にDeno v1.46がリリースされる際には、仕様などに変更が入る可能性もあります🙏 deno removeコマンド deno removeという新しいコマンドが追加されています。引数で指定されたパッケージをdeno.jsonのimportsやpackage.jsonなどから削除しつつ、deno.lockを更新してくれます。 $ deno remove @std/testing feat: deno remove (denoland/deno#24952) deno serve --parallel deno serveに--parallelオプションが追加されています。このオプションが指定された場合、deno serveはコア数またはDENO_JOBSで指定された値に基づいて、リクエストを複数のワーカーへ分散してくれるようです。 Deno公式のYoutubeチャンネルで解説動画が公開されています。 Parallelizing Deno Serve feat(serve): Opt-in parallelism for deno serve (denoland/deno#24920) HMRの安定化 DenoのHMR機能が安定化されるようです。 安定化に合わせて、コマンドラインオプションが--unstable-hmrから--watch-hmrにリネームされています。 feat: Rename –unstable-hmr to –watch-hmr (denoland/deno#24975) deno publishのLICENSEチェックについて deno publishコマンドの実行時にLICENSEファイルが存在しない場合は、警告ではなくエラーが発生するように挙動が変更されています。(articles/2024/07/28) また、deno.jsonにlicenseフィールドが追加されており、こちらによってライセンスを定義することもできるようです。 feat(publish): error on missing license file (denoland/deno#25011) feat(config/jsr): add license field (denoland/deno#25056) deno_stdのリリース deno_stdがリリースされています。...

Denoの直近の変更について 今週はDeno本体のリリースは行われていないですが、おそらく次のDeno v1.46でリリースされると思われる機能がいくつかマージされていたため、主要なものについて紹介いたします。 ⚠️正式にDeno v1.46がリリースされる際には、仕様などに変更が入る可能性もあります🙏 CLI引数の簡略化 パーミッション引数の簡略化 例えば、--allow-readは-R, --allow-envは-Eのように短縮された形式で指定することができます。 # 例) 以下は`deno --allow-read --allow-env main.ts`と同等です $ deno -ER main.ts feat: support short flags for permissions (denoland/deno#24883) runの省略 (deno <script>のサポート) deno runコマンドにおけるrunを省略できるようにする変更が導入されています。 $ deno main.ts feat: treat bare deno command with run arguments as deno run (denoland/deno#24887) deno runでタスクの実行がサポート (deno run <task>) deno runコマンドのエントリポイントとして指定されたファイルが存在しない場合、deno.jsonのtasksで定義されたタスクを実行するようフォールバックする機能が追加されています。deno run <entrypoint>のように実行された際に、<entrypoint>のファイルが存在しない場合はdeno task <entrypoint>として振る舞うイメージです。 # `deno.json`の`tasks.hello`が実行されます $ deno run hello feat: deno run (denoland/deno#24891) deno fmtでのCSSやYAMLのサポート deno fmtコマンドにCSS/SCSS/Sass/Less/YAMLなどのフォーマットのサポートが追加されています。...

What we got wrong about HTTP imports DenoにおいてHTTPインポートが実装された背景やそのトレードオフ、JSRが開発された背景などについて解説された記事がDenoの公式ブログで公開されています。 What we got wrong about HTTP imports HTTPインポートについては今後も削除される予定はないものの、ある程度の規模のプロジェクトにおいてはImport MapsとJSRを併用することが推奨されています。 また、この記事によると、Deno v2のリリースは今年の9月に実施されることが検討されているようです。 Denoでpackage.jsonやnpmパッケージのサポートが入った理由について node:sqliteのサポートについて Node.jsで最近実装されたnode:sqliteのサポートに関するissueがlittledivy氏によって作成されています。 Tracking issue for node:sqlite (#24828) 現在はクローズされていますが、過去にDeno本体にSQLiteドライバーを追加するPRが作成されていたことがあったので、もしかしたらDenoでnode:sqliteが実装される可能性もありそうな気はします。 feat: Add Deno.sqlite bindings (#14627) Deno v1.45.5 Deno v1.45.5がリリースされています。 Node.js互換性の改善 package.json importsのワイルドカードが認識されるように改善されています。 Subpath patterns node:child_process IPC(fork)の再実装: 以下のような点などが改善されているようです: TypedArrayをやり取りができない問題が解消 IPCチャネルを作成すると、イベントループが停止しなくなる問題が解消 nullを渡そうとすると、チャネルが終了してしまう問題が解消 この改善により、--pool=forkを指定した際もvitestが動作するようです。(これはvitest v2のデフォルトの挙動のようです) --v8-options: 各種APIによってDenoを子プロセスとして実行する際に、Node.jsの--v8-optionsがDenoの--v8-flags=--helpとして解釈されるように挙動が修正されています。これにより、Denoでv8flagsが動作するようです。 node:fs/promises watch()がNode.jsと同様にAsyncIterableを返却するように修正されています。 node:timers/promises scheduler.{wait,yield}が実装されています。...

Deno v1.45.3 Deno v1.45.3がリリースされています。 Node.js互換性の改善 npm workspaces npm workspace内の複数のメンバー間で特定のパッケージのバージョンがコンフリクトした際に、それぞれのメンバー配下にnode_modulesが作られるように挙動が改善されています。(例: ./workspace-aと./workspace-bがそれそれ@foo/barパッケージのv1とv2に依存している場合、./workspace-a/node_modulesと./workspace-b/node_modulesが作られるようです) --allow-scripts deno.jsonでnodeModulesDir: trueが未設定の場合であっても、コマンドラインで--node-modules-dirが指定されていれば--allow-scriptsが動作するように改善されています。 node:fs exists(Sync)のパフォーマンスが最適化されています (#24613) また、WindowsでStats.modeに適切な値が設定されるように改善されています (chokidarがWindowsで動かない問題があったようです) node:http request()でBufferのsubarrayをボディに指定すると、データが欠損してしまう問題が修正されています。 node:tty WriteStreamでhasColors()とgetColorDepth()メソッドが実装されています。 deno publish deno publishコマンドにLICENSEファイルが含まれていない場合に警告を表示する機能が追加されています。 現状では警告が表示されるようですが、エラーとするように挙動を変更することも検討されているようです。(Error when missing license file for deno publish (denoland/deno#24676)) ライセンスファイルの一覧 deno lsp deno lspでnpm workspacesがサポートされています。 また、依存関係のキャッシュに失敗するとLSPがフリーズする問題が修正されています。 deno compile deno compileで生成されたバイナリーでNode-APIがサポートされました。 その他 console.logなどでErrorのcauseプロパティの内容がフォーマットして出力されるように改善されています。 また、lib.deno_web.d.tsのlib.dom.d.tsやlib.webworker.d.tsとの互換性が改善されています。(#24599) Deno v1.45.4 Deno v1.45.4がリリースされています。 deno lint no-sloppy-importsルール sloppy importsに関する警告がdeno lintへ移動されています。deno lintに--unstable-sloppy-importsを指定するとno-sloppy-importsルールが有効化されるようです。 構文エラーの報告 構文エラーなどが検出された際に、deno lintがエラーを報告してくれるように挙動が改善されています。 deno lsp Infer function return typeによってnpmパッケージから提供される型が推論される際に、常にfile:形式のURLが挿入されてしまう問題が修正されています (#24344)...

@ts-typesと@ts-self-typesプラグマについて Denoで@ts-typesと@ts-self-typesというプラグマが実装されていたようです。 Document @ts-self-types (denoland/deno-docs#502) @ts-typesについては@deno-typesプラグマと同様に、特定のJavaScriptモジュールに対して型定義を適用したい場合に指定することが想定されているようです。今後は@deno-typesではなく@ts-typesの方の使用が推奨されるようです。 // @ts-types="./add.d.ts" import { add } from "./add.js"; @ts-self-typesについても、JavaScriptで書かれたモジュールに型を適用するための機能のようですが、実質的に/// <reference types="..." />と同様に動作するようです。基本的にJavaScriptモジュールに対して型を適用したい場合を除いて、/// <reference types="..." />の方の使用が推奨されるようです。 // @ts-self-types="./globals.d.ts" feat(unstable): add @ts-types and clean up @deno-types (denoland/deno_graph#444) feat(unstable): add support for @ts-self-types pragma (denoland/deno_graph#445) deno_stdのリリース deno_stdがリリースされています。 @std/async@1.0.0 @std/async@1.0.0がリリースされています。 @std/cli@1.0.0 @std/cli@1.0.0がリリースされています。 @std/text@1.0.0 @std/text@1.0.0がリリースされています。 このリリースに合わせて@std/text/caseが削除されています。代わりに@std/text/caseで提供されていた各APIは@std/text/to-camel-caseや@std/text/to-kebab-caseなどのファイルへ移行されています。 @std/ulid@1.0.0 @std/ulid@1.0.0がリリースされています。 @std/csv@1.0.0-rc.4 @std/csv@1.0.0-rc.4がリリースされています。 ParseErrorが削除されています (今後はSyntaxErrorがthrowされます) @std/yaml@1.0.0-rc.4 @std/yaml@1.0.0-rc.4がリリースされています。 stringify()やparse()で利用されていたYamlErrorが削除されています。今後はstringify()からはTypeError, parse()からはSyntaxErrorがthrowされます。 @std/expect@1.0.0-rc.3 @std/expect@1.0.0-rc.3がリリースされています。 expect.extend()との併用を想定して、expect()に型引数が追加されています。 @std/semver@1.0.0-rc.3 @std/semver@1.0.0-rc.3がリリースされています。 @std/semver/increment: increment()のprereleaseとbuildmetadata引数が削除されています。代わりにoptions引数が追加されており、そこでprereleaseやbuildオプションを指定できます。 @std/dotenv@0.225.0 @std/dotenv@0....

Deno v1.45 Deno v1.45がリリースされています。 以下に内容をまとめたため、よろしければこちらを参照いただければと思います。 Deno v1.45 Deno v1.45.1 Deno v1.45.1がリリースされています。 --import-map Denoまたはnpmのワークスペースを設定している状態で--import-mapオプションを指定すると、エラーが発生する問題が修正されています。 ライフサイクルスクリプト fseventsなどのパッケージをインストールすると、警告が表示される問題が修正されています。npmはbinding.gypが存在する場合、そのパッケージにデフォルトでinstallスクリプトを追加するものの、fseventsのようにnpmへの公開時にbinding.gypをパッケージから除外しているケースなどにおいて、Denoが意図せず警告を表示してしまう問題があったようです。 また、Denoがライフサイクルスクリプトを含むnpmパッケージを検出した際に、初回のみ警告を表示するように挙動が変更されています。 Deno v1.45.2 Deno v1.45.2がリリースされています。 fseventsを動かすための対応 fseventsパッケージを動かそうとするとエラーが発生する問題が修正されています (#24542) WebGPU GPUDevice#createRenderPipelineAsyncがPromiseを返却していなかった問題が修正されています。 Web Crypto API crypto.randomUUIDのパフォーマンスが5倍近くまで改善されています。 deno_stdのリリース deno_stdのリリースが行われています。 release-2024.07.09 release-2024.07.12 @std/assert@1.0.0 @std/assert@1.0.0が正式にリリースされました。 @std/path @std/path@1.0.0-rc.4 @std/path@1.0.0-rc.4がリリースされています。 以下のAPIが削除されています。 削除されたAPI 移行先 FormatInputPathObject Partial<ParsedPath> GlobToRegExpOptions GlobOptions @std/path@1.0.0 @std/path@1.0.0が正式にリリースされました。 @std/toml@1.0.0 @std/toml@1.0.0がリリースされました。 このリリースに合わせてTOMLParseErrorが削除されています。(今後はSyntaxErrorがthrowされます) @std/regexp@1.0.0 @std/regexp@1.0.0が正式にリリースされました。 @std/msgpack@1.0.0 @std/msgpack@1.0.0が正式にリリースされました。...

Denoのnpm workspacesサポートについて Deno本体にnpm workspacesのサポートを追加するPRがマージされています。おそらくDeno v1.45.0あたりでリリースされる可能性がありそうです。 feat: npm workspace and better Deno workspace support (#24334) Denoがpackage.jsonのworkspacesフィールドを認識してくれるようです。 現状では、各ワークスペースの依存関係はプロジェクトのルートディレクトリ直下のnode_modulesディレクトリにまとめてインストールされるようです。今後、この挙動は改善が検討されているようです。 また、以下のようなワイルドカードによる指定についてもまだサポートはされておらず、今後、対応が検討されているようです (#24420) { "workspaces": ["packages/*"] } Denoのワークスペース機能への変更 この対応に合わせて、Denoのワークスペース機能にも変更が加わっており、deno.jsonのworkspacesキーがworkspaceにリネームされています。 また、このdeno.jsonのworkspaceにはpackage.jsonを含むディレクトリをワークスペースのメンバーとして指定できるように改善されています。(今まではdeno.jsonを含むディレクトリのみがワークスペースのメンバーとしてサポートされていました) deno_stdのリリース deno_stdのリリースが行われています。 @std/crypto@1.0.0 @std/crypto@1.0.0がリリースされました。 @std/assert@1.0.0-rc.3 @std/assert@1.0.0-rc.3がリリースされています。 各ファイルの名前からassert_のプレフィックスが削除されています。例として、@std/assert/assert_equalsは@std/assert/equalsに、@std/assert/assert_rejectsは@std/assert/rejectsへリネームされています。 @std/csv@1.0.0-rc.1 @std/csv@1.0.0-rc.1がリリースされています。 各ファイルの名前からcsv_プレフィックスが削除されています。例えば、@std/csv/csv_parse_streamは@std/csv/parse_stream、@std/csv/csv_stringify_streamは@std/csv/stringify_streamにリネームされています。 また、ReadOptionsが非公開APIに変更されています。 @std/expect@1.0.0-rc.1 @std/expect@1.0.0-rc.1がリリースされています。 Immutable.jsのオブジェクトに関するサポートが削除されています。 また、expect().toHaveBeenNthCalledWith()で0以下の数値が指定された際に、例外が発生するように挙動が修正されています。 @std/json@1.0.0-rc.2 @std/json@1.0.0-rc.2がリリースされています。 各ファイル名からjson_プレフィックスが削除されています。例えば、@std/json/json_parse_streamは@std/json/parse_stream、@std/json/json_stringify_streamは@std/json/stringify_streamにリネームされています。 @std/semver@1.0.0-rc.1 @std/semver@1.0.0-rc.1がリリースされています。 非推奨化されていた以下のAPIが削除されています。 rangeMax() (greaterThanRange()への移行が推奨) rangeMin() (lessThanRange()への移行が推奨) testRange() (satisfies()への移行が推奨) また、SEMVER_SPEC_VERSION定数が削除されており、@std/semver/constantsも非公開モジュールに変更されています。 @std/yaml@1.0.0-rc.1 @std/yaml@1.0.0-rc.1がリリースされています。 APIの削除 parse()APIの以下のオプションが削除されています。 legacy filename listener TypeとSchema型も非公開になりました。parse()のschemaオプションには文字列を渡せるのでそちらへの移行が推奨されます。 また、parseAll()のiterator引数が削除されています。 リネーム DumpOptionsがStringifyOptionsにリネームされています。...

deno_stdのリリース deno_stdがリリースされています。 @std/media-types@1.0.0 @std/media-types@1.0.0がリリースされました。 このリリースに合わせて、extensionsByType()(@std/media_types/extensions_by_type)がallExtensions()(@std/media_types/all_extensions)にリネームされています。extension()の命名と合わせることが目的のようです。 @std/http@1.0.0-rc.1 @std/http@1.0.0-rc.1がリリースされています。 @std/http/serverの削除 非推奨化されていた@std/http/serverが削除されています。Deno.serve()への移行が推奨されます。 @std/http/unstable_signed_cookieのリネーム @std/http/unstable_signed_cookieが@std/http/signed_cookieにリネームされています。ただし、@std/http/signed_cookieから提供されるAPIは引き続き実験的APIとして扱われるようです。 また、verifyCookie()がverifySignedCookie()へリネームされています。 @std/http/cookie getCookies()またはsetCookie()でthrowされるエラーがSyntaxErrorに統一されました (今まではErrorまたはTypeErrorのどちらかがthrowされていました) @std/http/file_server Deno.serve()に合わせてファイルサーバーのデフォルトの起動ポートが4507から8000に変更されています。 @std/testing@1.0.0-rc.1 @std/testing@1.0.0-rc.1がリリースされています。 @std/testing/assertsの削除 非推奨化されていた@std/testing/assertsが削除されました。@std/assertで同様の機能が提供されているので、そちらへの移行が推奨されます。 @std/testing/time 複数のFakeTimeを同時に作成できないように挙動が変更されています。 また、newなしでDate()を呼んだ際にスタブが適用されない問題が修正されています。 @std/testing/mock spy()にclassを渡した際に、そのclassのconstructorがthrowしたエラーがきちんと追跡されるように振る舞いが改善されました。 @std/jsonc@1.0.0-rc.1 @std/jsonc@1.0.0-rc.1がリリースされました。 @std/jsonc/parse ParseOptionsとParseOptions.allowTrailingCommaが削除されています。今まではallowTrailingCommaにfalseを指定することで、配列などの最後の要素の後のカンマの指定を禁止することができましたが、有効なユースケースが少ないと判断され削除されました。 @std/yaml@0.224.3 @std/yaml@0.224.3がリリースされました。 parse()とstringify()のschemaオプションで文字列の指定がサポートされています。 schemaオプションに指定できる有効な文字列は以下のいずれかです。 "core" (CORE_SCHEMAを指定した場合と同様の振る舞いをします) "default" (DEFAULT_SCHEMAを指定した場合と同様の振る舞いをします) "failsafe" (FAILSAFE_SCHEMAを指定した場合と同様の振る舞いをします) "json" (JSON_SCHEMAを指定した場合と同様の振る舞いをします) "extended" (EXTENDED_SCHEMAを指定した場合と同様の振る舞いをします) deno_stdext deno_stdextというdeno_stdへの拡張パッケージが公開されています。現時点では以下のパッケージが公開されているようです。 @stdext/crypto @stdext/encoding @stdext/http また、deno-sqlxのリポジトリで開発されていたSQLドライバー向けの共通インターフェースはdeno_stdextに取り込まれることが検討されているようです。 feat(sql): add sql standard interfaces (halvardssm/deno_stdext#5) まだこのPRはマージはされていませんが、以下のパッケージの追加が検討されているようです。 @stdext/sql @stdext/collections deno_mysqlにおけるdeno-sqlxへの対応について 先週紹介したdeno_mysqlにおけるdeno-sqlxへの対応はリバートされたようです。 Revert “Implement SQLx interface” (denodrivers/mysql#169)...

History of WebGPU in Deno (Web Engines Hackfest ‘24) Web Engines Hackfest 2024でのcrowlKats氏の発表内容が公開されています。 動画 スライド DenoにおけるWebGPU APIの実装やWebGPU APIが一時的に削除された背景、WebGPU APIに関する今後の計画などについて解説されています。今後、OffscreenCanvasなどの実装も検討されているようです feat(ext/canvas): OffscreenCanvas (#23773) Deno v1.44.3 Deno v1.44.3がリリースされています。 deno lsp ワークスペース直下以外の各ディレクトリに存在するdeno.jsonが認識されるように改善されています。 feat(lsp): multi deno.json resolver scopes (#24206) この改善によって、例えば、以下のような構成のプロジェクトにおいて、各deno.jsonがdeno lspによって認識されるようです。 ./frontend/deno.json ./backend/deno.json ./backend/sub_dir/deno.json 上記のPRによると、各deno.jsonごとに型チェックの振る舞いや設定などを分離できるようにすることなども今後、検討されているようです。 Node.js互換性の改善 node:net: BlockListとSocketAddressが追加されています。 node:http: Server#closeでGraceful shutdownが行われるように改善されています。 node:diagnostics_channel: dd-traceのサポート向けにNode.jsとの互換性が改善されています。 AbortSignal AbortSignal.timeoutのリソースリークが修正されています。 Deno v1.44.4 Deno v1.44.4がリリースされています。 Deno.addSignalListener Deno.addSignalListenerで'SIGPOLL'と'SIGUNUSED'がサポートされています。 node:fs DirentにparentPathとpathプロパティが追加されています。 deno_stdのリリース deno_stdがリリースされています。...