Node.jsで動かすEmDashでstatement.columns is not a functionと出て初期設定が進まない時は、Node.jsのバージョンが原因です。EmDashはNode.jsに組み込まれたSQLite(node:sqlite)を使いますが、バージョンによっては、EmDashが呼び出すStatementSync.columns()がまだありません。Node.js v23.10.0ではこのエラーになり、v24.22.1(24系のLTS)に替えると動きました。
確かめたのはEmDash 1.3.1です。
表示される画面とログ
npm create emdashでNode.js用のプロジェクトを作り、npm run devで起動すると、トップページに「This site’s database has not been migrated yet.」と表示されます。初期設定を実行しても失敗し、開発サーバーのログに次のエラーが出ます。
[cause]: MigrationFailedError: Migration failed: statement.columns is not a function
at runMigrations (.../node_modules/emdash/src/database/migrations/runner.ts:614:9)
使っているNode.jsで動くか確かめる
StatementSync.columns()があるかどうかは、次の1行で確かめられます。functionと出れば動きます。undefinedなら、このエラーになります。
node -e "const {DatabaseSync}=require('node:sqlite');console.log(typeof new DatabaseSync(':memory:').prepare('select 1').columns)"
v23.10.0ではundefined、v24.22.1ではfunctionでした。
package.jsonのNode.jsバージョン指定だけでは判断できない
EmDashのpackage.jsonには、動作条件として"node": ">=22.16"と書かれています。v23.10.0は数字の上ではこの条件を満たすので、インストールの時点では何も警告が出ません。数字の比較だけで判断せず、上の1行で確かめてからNode.jsのバージョンを選びます。
Node.jsを24系のLTSにする
24系のLTSに替えれば、ほかの設定を変えなくても初期設定まで進みます。システム全体のNode.jsを替えたくない時は、公式サイトから配布ファイルを取得してプロジェクトのフォルダに展開し、展開したNode.jsのフォルダにあるbinをPATHの先頭に入れて起動する方法でも動きました。
初期設定に失敗した時に作られたデータベースファイル(data.db)は4KBの小さなファイルだったので、削除してから起動し直しました。