TypeScript 5.7中如何将Buffer<ArrayBufferLike>转换为ArrayBuffer？

问题根源 #

在Node.js v22+的@types/node类型定义里，Buffer的buffer属性被定义为ArrayBufferLike（包含ArrayBuffer和SharedArrayBuffer的联合类型），但kdbxweb.load()只接受严格的ArrayBuffer类型，触发TS2345类型不兼容错误。

安全转换方案（无需盲目类型断言） #

方案1：用Buffer.slice()获取类型安全的ArrayBuffer #

调用slice(0)会生成一个指向原内存的新Buffer，它的buffer属性在类型定义里明确是ArrayBuffer，直接提取即可：

import fs from 'fs';
import * as kdbxweb from 'kdbxweb';

const fileBuffer = fs.readFileSync('your-db.kdbx');
const arrayBuffer = fileBuffer.slice(0).buffer;

// 直接传入kdbxweb.load，无类型报错
const db = await kdbxweb.load(arrayBuffer, 'your-password');

方案2：用Buffer.toArrayBuffer()（Node.js v20.11.0+支持） #

Node.js在v20.11.0和v18.20.0版本新增了这个方法，直接返回标准ArrayBuffer，类型定义也明确标注返回值类型，是最简洁的方案：

import fs from 'fs';
import * as kdbxweb from 'kdbxweb';

const fileBuffer = fs.readFileSync('your-db.kdbx');
const arrayBuffer = fileBuffer.toArrayBuffer();

const db = await kdbxweb.load(arrayBuffer, 'your-password');

方案3：类型守卫缩小范围 #

如果不想创建新Buffer，可以写个简单的类型守卫，确认buffer是ArrayBuffer而非SharedArrayBuffer（实际读取文件不会返回后者，仅做严谨性处理）：

import fs from 'fs';
import * as kdbxweb from 'kdbxweb';

function isArrayBuffer(buf: ArrayBufferLike): buf is ArrayBuffer {
  return buf.constructor.name === 'ArrayBuffer';
}

const fileBuffer = fs.readFileSync('your-db.kdbx');
const bufferProp = fileBuffer.buffer;

if (isArrayBuffer(bufferProp)) {
  const db = await kdbxweb.load(bufferProp, 'your-password');
} else {
  throw new Error('Unexpected SharedArrayBuffer from file read');
}

为什么别用盲目断言？ #

直接写fileBuffer.buffer as ArrayBuffer会跳过TS的类型检查，万一未来Node.js的Buffer实现返回SharedArrayBuffer，代码会在运行时崩溃。上面的方案都是通过类型安全的方式确保传入的是kdbxweb需要的类型。

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