TSKaigi 2025で「技術書をソフトウェア開発する」というタイトルで発表をしました。スライドは次のページで公開しています。技術書をソフトウェア開発する - jsprimer の 10 年から学ぶ継続的メンテナンスの技術 -スライド: https://azu.github.io/slide/2025/tskaigi/jsprimer.html基本的にはJavaScript PrimerというJavaScriptの入門書の話になっています。どうやって作っていて、どうやって10年近くも更新を続けているのか、オープンソースとしての継続性などについて話しています。関連:JavaScript Primerを出版しました！/JavaScript Primerはなぜ書かれたのか？ | Web ScratchJavaScript Primer 改訂2版をリリースしました！/JavaScript Primerはなぜ更新され続けるのか？ | Web ScratchJavaScript/TypeScript以外での通じる話が多いので、技術書や何かを伝える文章を書く人にとっても参考になるかなと思います。今だと、LLMとかに投げる文章でも同様のことが言える場面も多いとは思います。jsprimerの目的の一つに「変化に対応できるようにする」というものがあります。これのためにjsprimerという書籍を更新しているので、jsprimerにContributeや金銭的に支援してくれる人や企業はいつでも募集しています。JavaScript PrimerのES2025対応を手伝ってくれるContributorとSponsorを募集しています | Web ScratchJavaScript Primer - Open Collectiveスライド中にもありますが、現在のソフトウェア開発でオープンソースと関わらずに完結することはかなり難しいです。そのため、入門書としての目的としてオープンソースに関わってもらうことを入れています。これはjsprimerをオープンソースで開発している理由の一つです。オープンソースとの関わり方は色々な形があるので、jsprimerに限らずに何かしらの形で関わってみると面白いんじゃないかと思います。GitHub Sponnsorなどでの支援も大歓迎です。Sponsor @az

JavaScript Primer (https://jsprimer.net/) では、毎年ECMAScriptの新しい仕様への追従を行っています。ES2025はもうすでにリリース候補が公開されていて、2025年6月に正式リリースされる予定です。Release ES2025 Candidate April 23rd 2025 · tc39/ecma262今年もES2025で追加される機能についての対応Issueを作成しました。これらのIssueを一緒に進めてくれるContributorと、JavaScript Primerの活動を支援してくれるSponsorを募集しています。ES2025対応のIssueES2025のMeta Issueとして次のIssueがありますES2025の対応 · Issue #1778 · asciidwango/js-primer具体的に対応するものとして次のIssueを作成しています。✅ES2025: import attributes · Issue #1783 · asciidwango/js-primer見積もり: 1 or 2 pointES2025: RegExp.escape · Issue #1781 · asciidwango/js-primer見積もり: 2 or 3 point✅ES2025: Set Methods for JavaScript · Issue #1784 · asciidwango/js-primer見積もり: 3 or 5 pointES2025: Iterator Helpers · Issue #1782 · asciidwango/js-primer見積もり: 8+ point の可能性あり各Issueには、作業量の見積もりとしてpointを付与しています。(これは感覚値なのであんまり正確ではないです。実際にやってみたら変わる可能性もあります)このpointは、作業の難易度や必要な調査量などを考慮して設定していて、後述するOpen Collectiveでの報酬計算にも利用します。pointの目安は以下の通りです。これは作業時間ではなく、タスクの複雑さや規模を表す指標です。例えば2 pointは「1日あれば終わるかな」という感覚値に近いものです。PointDescription0些細な変更

DJControl Mix Ultraという、モバイル向けのDJコントローラーを買って遊んでいた。DJControl Mix Ultra - Dirigent | ディリゲントDJControl Mix Ultra - HerculesDJControl Mix UltraとはDJControl Mix Ultra - Herculesは、普通のDJコントローラーと違って、iOSやAndroidのスマホやタブレットとBluetoothで接続して使う目的で作られているデバイス。なので、LINE INやLINE OUTもないし、スマホとの接続はBluetooth LEでのみ行うような作りになってる。一方で、USB Cで充電できてバッテリー駆動なので、Bluetoothでスマホと繋いで動作するので、ワイヤレスで動く。そのため、この見た目通りの構成で動く。音の出力は、スマホのスピーカー または スマホに繋いでスピーカーから鳴らすので、本格的な用途じゃなくて遊びとか外で使う向けに作られている。基本的に利用できるDJアプリも、DJ Apps | Algoriddimのみ限定されている。エフェクトとかミックスとかはソフトウェア的な処理を行うので、ハードウェアは本当にコントローラーというだけの役割になっている。デバイス自体も1kgぐらいで、ケースもちゃんとしていて、デザインも好きなので、ガジェットとしてかなり良くできてた。ケースが、スマホのスタンドにもなるというデザインも良い。Macbook Airより一回り小さくて軽いぐらいな感じで、持ち運びもかなり安定してて良い。djay ProDJControl Mix Ultraは、djay Proというアプリと接続して使う専用コントローラー的なもの。djay Proは、iOS/Android/Mac/Windowsで動くDJアプリで、かなりちゃんと作られているアプリなのでできは良いと思う。djay Proは有料ではあるけど、DJControl Mix Ultraと接続するとHardware modeが有効になって、必要な機能が自由に使えるようになる。ハードウェアのデバイスごとにこういったUnlock機能が実装されているらしく、デバイスごとに有効になる機能はバラバラだけど、大体デバイスで操作できるものは全部有効になるイメージ。DJContr

2024 年のオープンソース活動の振り返りと GitHub Sponsors での収入をまとめた記事です。いつもは別々に書いていましたが、内容的にどちらもオープンソースの話が被っているのでまとめました。今までの振り返り2014 年: https://efcl.info/2014/12/31/oss-in-2014/2015 年: https://efcl.info/2015/12/31/oss-in-2015/2016 年: https://efcl.info/2016/12/31/oss-in-2016/2017 年: https://efcl.info/2017/12/30/oss-in-2017/2018 年: https://efcl.info/2018/12/31/oss-in-2018/2019 年: https://efcl.info/2019/12/31/oss-in-2019/2020 年: https://efcl.info/2020/12/31/open-source-in-2020/2021 年: https://efcl.info/2021/12/31/open-source-in-2021/2022 年: https://efcl.info/2022/12/31/open-source-in-2022/2023 年: https://efcl.info/2023/12/31/open-source-in-2023/オープンソース活動の種類自分のオープンソース活動の種類として、次のようなものがあると思います。ソフトウェア開発: textlint、Secretlint、HonKitなどの開発やメンテナンスウェブサービス開発: philan.net、Komesan、Irodrなどの開発やメンテナンスブログ: JSer.infoやECMAScript Dailyのブログの投稿書籍: JavaScript PrimerやJavaScript Promise の本の執筆オープンソース関係の収入の種類自分のオープンソース関係の収入1は、ほぼ GitHub Sponsors 経由となっています。@azu の GitHub SponsorsGitHub Sponsors では Monthly と One-Time でのサポートができます。自分の場合は、Gi

Secretlint v8.3で、単体のバイナリファイルとしてsecretlintコマンドを配布するようにしました。Release v8.3.3 · secretlint/secretlintどういうことができるようになるかと、Node.jsをインストールしなくてもsecretlintコマンドを使えるようになります。次のようにCurlでダウンロードして実行するだけで、機密情報の検出ができるようになります。#!/usr/bin/env bashset -euo pipefailSECRETLINT_VERSION="8.3.3" # secretlintのバージョンARCH=$(uname -m)OS=$(uname -s | tr '[:upper:]' '[:lower:]')# Map architecture to the expected formatcase "$ARCH" in x86_64) ARCH="x64" ;; aarch64) ARCH="arm64" ;; arm64) ARCH="arm64" ;; *) echo "Unsupported architecture: $ARCH" exit 1 ;;esac# Download the binarycurl -sSL "https://github.com/secretlint/secretlint/releases/download/$(SECRETLINT_VERSION)/secretlint-$(SECRETLINT_VERSION)-$(OS)-$(ARCH)" -o secretlintchmod +x ./secretlint# Create .secretlintrc.json./secretlint --init# Run secretlint./secretlint "**/*"SecretlintはDockerも対応していますが、コマンドラインツールの場合は単体のバイナリとして使えると何かと便利です。npm経由と比べて、Node.jsを必要としないのとダウンロードが1つのファイルだけなのでシンプルです。Docker経由に比べて、Dockerを必要としないのと実行までの時間が早いはずです。デメリットとしては、単体のバイナリはルールも同梱しないと配布できないので、ルール

JavaScript Primer v6.0.0をリリースしました 🎉JavaScript Primer v6.0.0では、ECMAScript 2024の対応とNode.jsのユースケースを新たに増えたnode:utilのparseArgs関数やnode:testを使うように書き直しています。JavaScript Primer SponsorsJavaScript Primer(jsprimer)では、Open Collectiveを通じてプロジェクトの更新に関わる資金を募っています。JavaScript Primer - Open Collective今回のv6リリースにおいては、次の方々にご支援いただきました！株式会社コクチョウさんは、Yearly Gold Sponsorとしてご支援いただいています。ご支援ありがとうございます！JavaScript Primerスポンサーについては、次のページを参照してください。JavaScript Primerスポンサー · JavaScript Primer #jsprimerまた、ご支援いただいた資金は、jsprimerにcontributionしてくれた方へ還元できるような仕組みを設計しました。次回からは、この仕組みを回していけるようにしたいです。Contributing Expenses PolicyJavaScript Primer v6.0.0の変更点JavaScript Primer v6.0.0の変更点について紹介します。リリースノートは次のページからも確認できます。Release v6.0.0: ES2024の対応/Node.jsの大幅更新 · asciidwango/js-primer更新をメールで受け取りたい方は、次のフォームから登録できます。JavaScript Primerの更新情報を購読* indicates requiredEmail Address * (function($) {window.fnames = new Array(); window.ftypes = new Array();fnames[0]='EMAIL';ftypes[0]='email';}(jQuery));var $mcj = jQuery.noConflict(true);フォームが表示されない人は http...

Node.js で型安全な環境変数を扱うスニペットを作りました。next devのようなアプリケーションの起動、Playwright でのテストなどコマンドごとに渡したい環境変数のセットが異なるケースがあります。この場合に環境変数をまとめたものを定義して、それをコマンドごとに読み込むセットを変えたいことがあります。次のようにベタ書きしてもいいのですが、渡したい環境変数が増えると管理が大変になります。NEXT_PUBLIC_LOCALHOST_URL=http://localhost:3000 NEXT_PUBLIC_API_URL=http://localhost:3001 NEXT_PUBLIC_IS_TEST_MODE=false FOO="bar" next devそのため、.envのような環境変数をまとめたファイルを使いたくなります。Node.js は--env-fileフラグで.envファイルを読み込むことができますが、.envファイルは型安全ではありません。--env-fileNode.js — How to read environment variables from Node.js環境変数名の Typoや必須の環境変数が設定されていないなどの問題が発生する可能性があります。そのため環境変数をの定義自体も TypeScript で型安全に定義したいです。これをやるための 50 行ほどのスニペットを書いたので、使い方を紹介します。📝 主な用途はローカルやCIでの開発用で、実際にデプロイするサーバなどには利用しない想定です📝 ライブラリとかにしてないのは、この仕組み自体が外部パッケージの依存もなく短いスニペットだからですJSからTSを参照する都合上、ライブラリにはちょっとしにくい気がしますサンプルリポジトリ次の場所にサンプルリポジトリがあります。azu/type-safe-env: Type Safe /Environment Variables snippet for Node.js使い方大きく分けて、環境変数の型を定義するdefineEnv関数と、環境変数をセットするsetEnv関数があります。環境変数の型を定義するdefineEnv.ts: 環境変数の型を定義する UtilitydefineEnv関数を次のような受け取りたい環境変数の型定義をす...

iOSのSafari、AndroidのChromeはそれぞれPCと連携してウェブアプリケーションをデバッグできます。PCのSafariのWeb Inspector、ChromeのDevToolsと連携すれば、コンソールログやネットワーク、デバッガーなども利用できます。スマホと繋いでWebサイトをデバッグする方法をまとめたページが見つけられなかったので、メモです。ネットワークで繋いでデバッグもできたりするので、結構便利です。Mobile Safari on iOSiOSのSafariは、macOSのSafariと接続してログやネットワークの通信などを見るデバッグが可能ですドキュメント: Inspecting iOS and iPadOS | Apple Developer DocumentationiOSのSafariとmacOSのSafariを接続する初回は次の設定が必要ですiOS設定アプリを開くSafari の設定を開く詳細を開くWebインスペクタ をONにするmacOSSafariの設定を開く詳細タブを開くWebデベロッパ用の機能を表示にチェックを入れるiOSのSafariとmacOSを接続してWeb Inspectorを表示するiPhoneとmacをUSBで接続します初回はデバイスを信頼しますか? というダイアログが出てきますiOSのSafariでデバッグしたいページを開くmacOSのSafariの開発メニューから、Safariで開いているページを選択するこれでmacOSのWeb InspectでiOSのSafariのデバッグでできます。📝 初回はUSBで接続する必要があります。ネットワークで接続したい場合は、”ネットワーク経由で接続”にチェックを入れてみてください。(すでに入ってる場合は、一度外してから入れ直すなどすると、つながると思います。)同じネットワークにいる場合は、USBを接続しなくても、iOSで開いているページをmacOSでデバッグできるようになります。端末やタブが出てこない場合は、iOSのSafariを一回閉じたりすると出てくることがあります。コンソールログを取る方法Web Inspectorのコンソールタブを開く選択した項目をコピー または 選択部分を保存 でログをコピーできますネットワークログを取る方法Web Inspectorのネットワー...

JavaScript PrimerのES2024の対応を進めていく予定なので、対応を手伝ってくれるContributorとjsprimerというプロジェクトを支援してくれるSponsorを募集しています。追記(2024-03-22): Contributorを希望する方は集まりました。ありがとうございます！JavaScript Primerスポンサーは引き続き募集しています！Gold SponsorsSupporters3行サマリーES2024の対応を6月末までにやるマイルストーンを切りましたES2024の対応を手伝ってくれるContributorを募集していますOpen Collectiveを始めたので、プロジェクトを支援してくれるSponsorを募集していますjsprimerのES2024対応jsprimerは毎年のECMAScriptの仕様改定にあわせてメジャーアップデートを行なっています。次の更新は、2024年6月末ごろにリリースされる予定のECMAScript 2024に対応する予定です。そのため、ES2024の対応とユースケースであるNode.jsに関するアップデートをしていくマイルストーンを切りました。v6(ES2024) MilestoneES2024に対応するマイルストーンをざっとみると、大体ざっくり12-20日分ぐらいのタスクがあります。大きく分けて次の3つのグループに分かれています。ES2024の対応Stage 2.7の追加Node.jsのユースケースの更新ES2024の対応ES2024ではいくつか機能が増えているので、それに対応するアップデートを行います。ECMAScript 2024の対応 · Issue #1706というIssueに、ES2024の対応についてのタスクをまとめています。具体的に対応したいIssueは次の3つになっています。ES2024: array-grouping · Issue #1716ES2024: Well-Formed Unicode Strings · Issue #1715ES2022: Error Cause · Issue #1714Array Groupingは恐らく対応が必須ですが、他の2つは必要なら対応する形になると思います。実際に内容や入れる場所を考えてみて、それが読む人にとってほんとに必要な情

最近はGoogleではなくKagi Searchをメインの検索エンジンとして使っています。Kagi Searchは$108/year($10/month)の有料の検索エンジンです。広告モデルではない検索エンジンなので、有料のサブスクリプションモデルとなっています。Plan Types | Kagi’s Docsいくつかプランがあり、検索し放題のProfessionalプランが$10/monthですUltimate Plan ($25/month)だと外部のOpenAIのGPT 4とかClaude 3との連携とかも入ってきます月に1-2万回ぐらいは検索することを考えると、 (108 / (10000 * 12)) * 150 で大体1検索が0.1円ぐらいのイメージですが、こちらもKagiのLLM機能は利用できるので、実質もう少しコスパは良いと思います。検索ソースにはGoogle, Yandex, Mojeek, Braveなどのリソースを使っているので、検索結果自体はGoogleとそこまで変わらないと思います。Search Sources | Kagi’s Docs基本的な使い方ではGoogleで見つかったものがKagiで見つからなかったという経験はありません。もちろん、検索の量でGoogleより優れたものはないと思うので、量にフォーカスしたいときはGoogleを使えば良いと思います(逆に今は飽和的になって検索が逆に難しかったり、検索されてないところにコンテンツがあったりして、量でのカバーは難しい感じはします)自分がKagiを使う一番理由は検索体験にあると思っています。いいところGoogleより良いと感じる検索結果が出しやすい(人による)日本語の検索結果はそこまで変わらない感じもする(後述する漢字だけ検索した時の問題はまだある)フィルター系がビルトインであるので、絞り込みはしやすく感じる英語で検索した時に英語のリソースにマッチさせやすいので良い結果と感じることが多いたとえば、Googleだと英語で検索して”英語のページを検索”を選択にしても、日本語のサイトが出てくる(おそらくRegionが日本だと、日本語訳があったらそっちを出すみたいな感じになったりして、これが嫌なこと多い)https://www.google.com/search?q=javascript&lr=l