使用DuckDB Node.js绑定创建内存数据库遇构造函数错误求助

问题场景 #

使用DuckDB Node.js绑定创建内存数据库时，执行以下代码触发错误：

import * as duckdb from 'duckdb'
   
const db = new duckdb.Database(':memory:');

错误信息：

const db = new duckdb.Database(':memory:');
           ^

TypeError: duckdb.Database is not a constructor
    at file:///home/juju/workspace/gridtiler/npm/bin/gridtiler.js:64:12
    at ModuleJob.run (node:internal/modules/esm/module_job:192:25)
    at async DefaultModuleLoader.import (node:internal/modules/esm/loader:228:24)
    at async loadESM (node:internal/process/esm_loader:40:7)
    at async handleMainPromise (node:internal/run_main:66:12)

Node.js v20.4.0

执行console.log(duckdb)返回的模块结构显示Database构造函数确实存在，但嵌套在default属性下：

[Module: null prototype] {
  default: {
    Database: [Function: Database],
    Connection: [Function: Connection],
    Statement: [Function: Statement],
    QueryResult: [Function: QueryResult],
    ERROR: -1,
    OPEN_READONLY: 1,
    OPEN_READWRITE: 0,
    OPEN_CREATE: 0,
    OPEN_FULLMUTEX: 0,
    OPEN_SHAREDCACHE: 0,
    OPEN_PRIVATECACHE: 0
  }
}

解决方法 #

方法一：直接导入default导出对象 #

修改导入语句，直接引入模块的default导出：

import duckdb from 'duckdb'

const db = new duckdb.Database(':memory:');

方法二：通过default属性访问构造函数 #

保留原有导入方式，通过default层级获取Database：

import * as duckdb from 'duckdb'

const db = new duckdb.default.Database(':memory:');

原因说明 #

DuckDB的Node.js模块采用CommonJS风格导出，当使用ES模块的import * as duckdb语法导入时，所有导出内容会被包裹在default属性中，因此直接访问duckdb.Database会找不到对应构造函数，必须通过default层级访问，或者直接导入default导出对象。

内容的提问来源于stack exchange，提问作者julien