new DatabaseSync(path[, options])


  • path <string> | <Buffer> | <URL> 数据库的路径。SQLite 数据库可以存储在文件中,也可以完全 纪念。要使用基于文件的数据库,路径应为文件路径。要使用内存数据库,路径应为特殊名称 ':memory:'
  • options <Object> 数据库连接的配置选项。支持以下选项:
    • open <boolean> 如果为 true,数据库将在构造函数中打开。当该值为 false 时,必须通过 open() 方法打开数据库。默认值: true
    • readOnly <boolean> 如果为 true,数据库将以只读模式打开。如果数据库不存在,打开将失败。默认值: false
    • enableForeignKeyConstraints <boolean> 如果为 true,则启用外键约束。推荐启用,但为了兼容旧的数据库架构可以禁用。在打开数据库后,可以使用 PRAGMA foreign_keys 启用或禁用外键约束的执行。默认值: true
    • enableDoubleQuotedStringLiterals <boolean> 如果设置为 true,SQLite 将接受 双引号字符串字面量。这不推荐使用,但可以为了兼容旧的数据库模式而启用。默认值: false
    • allowExtension <boolean> 如果为 true,则启用 loadExtension SQL 函数和 loadExtension() 方法。你可以稍后调用 enableLoadExtension(false) 来禁用此功能。默认值: false
    • timeout <number> 以毫秒为单位的 忙时超时。这是 SQLite 等待数据库锁释放前的最长时间,然后才返回错误。默认值: 0
    • readBigInts <boolean> 如果为 true,整数字段将作为 JavaScript BigInt 值读取。如果为 false,整数字段将作为 JavaScript 数字读取。默认值: false
    • returnArrays <boolean> 如果为 true,查询结果将以数组形式返回,而不是对象形式。 默认值: false
    • allowBareNamedParameters <boolean> 如果为 true,则允许绑定命名参数而无需前缀字符(例如,使用 foo 而不是 :foo)。默认值: true
    • allowUnknownNamedParameters <boolean> 如果为 true,在绑定时会忽略未知的命名参数。 如果为 false,遇到未知的命名参数会抛出异常。默认值: false

构建一个新的 DatabaseSync 实例。

【Constructs a new DatabaseSync instance.】