PDFKit文档生成中metadata设置的正确方式

在使用PDFKit生成PDF文档时，开发者可能会遇到"无法读取未定义的toISOString属性"的错误。这个错误通常发生在尝试设置文档元数据(info)时采用了不正确的方式。

问题根源分析

当开发者直接通过doc.info = {...}的方式设置文档元数据时，会覆盖PDFKit内部自动生成的info对象。PDFKit在内部处理元数据时，会默认包含一些基础字段，如创建日期等。如果这些字段被意外删除，就会导致后续处理时出现类型错误。

正确的元数据设置方法

PDFKit提供了两种推荐的方式来设置文档元数据：

1. 通过构造函数参数设置（推荐方式）

const doc = new PDFDocument({
  size: 'A4',
  info: {
    Title: '我的文档标题',
    Author: '作者名称',
    Subject: '文档主题',
    Keywords: '关键词1, 关键词2',
    CreationDate: new Date()
  }
});

2. 使用专用方法设置

const doc = new PDFDocument();
doc.info.Title = '我的文档标题';
doc.info.Author = '作者名称';

最佳实践建议

1. 保留系统自动生成的字段：特别是CreationDate等时间字段，让PDFKit自动处理
2. 尽早设置元数据：最好在文档初始化时就设置好元数据
3. 避免直接覆盖info对象：这会删除PDFKit内部维护的重要元信息
4. 检查字段类型：确保设置的字段值类型符合PDF规范要求

常见元数据字段说明

• Title：文档标题
• Author：作者信息
• Subject：文档主题/摘要
• Keywords：关键词，多个关键词用逗号分隔
• CreationDate：创建日期(Date对象)
• ModDate：修改日期(Date对象)
• Creator：创建应用程序名称
• Producer：生成PDF的工具名称

通过遵循这些规范，开发者可以避免元数据处理中的常见错误，生成符合标准的PDF文档。