@kenjiuno/msgreader@1.27.1-alpha.1

Author: kenjiuno

README.md

@@ -64,11 +64,24 @@ const testMsgAttachment0 = testMsg.getAttachment(testMsgInfo.attachments[0])
   const testMsgInfo = testMsg.getFileData()
 
   for (const att of testMsgInfo.attachments) {
-    console.log(att.fileName);
-    // testMsg.getAttachment(att).content
-  }
+    const attachment = testMsg.getAttachment(att);
+    console.log(attachment.fileName);
+
+    // fs.writeFileSync("save-" + attachment.fileName, attachment.content);
+
+    // Node.js ≧ v0.1.90
+    // Buffer.from(attachment.content).toString('base64')
+
+    // Node.js ≧ v25
+    // attachment.content.toBase64()
+}
 ```
 
+For a reference:
+
+- [Buffer | Node.js v25.2.1 Documentation](https://nodejs.org/api/buffer.html#buftostringencoding-start-end)
+- [Uint8Array.prototype.toBase64() - JavaScript | MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toBase64)
+
 ## Build msgreader locally
 
 ```bat

cli.js

@@ -258,8 +258,6 @@ program
     walk(reader.rootFolder(), "/");
   });
 
-
-
 program
   .command('dummy1')
   .action(() => {
@@ -273,10 +271,17 @@ program
 program
   .command('dummy2')
   .action(() => {
-    const msgFileBuffer = fs.readFileSync('test/voteItems.msg');
-    const testMsg = new MsgReader(msgFileBuffer);
-    const testMsgInfo = testMsg.getFileData();
-    console.log(testMsgInfo);
+    const msgFileBuffer = fs.readFileSync('test/msgInMsg.msg');
+    const testMsg = new MsgReader(msgFileBuffer)
+    const testMsgInfo = testMsg.getFileData()
+
+    for (const att of testMsgInfo.attachments) {
+      const attachment = testMsg.getAttachment(att);
+      console.log(attachment.fileName);
+
+      //console.log(Buffer.from(attachment.content).toString('base64'));
+      fs.writeFileSync("save-" + attachment.fileName, attachment.content);
+    }
   });
 
 program

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenjiuno/msgreader",
-  "version": "1.27.0",
+  "version": "1.27.1-alpha.1",
   "description": "Outlook Item File (.msg) reader in JavaScript Npm Module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

src/MsgReader.ts

@@ -1427,6 +1427,45 @@ function removeTrailingNull(text: string): string {
   return text;
 }
 
+export interface AttachmentData {
+  /**
+   * A file name of this attachment without directory specification.
+   * 
+   * @see {@link SomeOxProps.fileName}
+   * 
+   * e.g.
+   * 
+   * - `blue.png`
+   * - `Microsoft Outlook テスト メッセージ.msg`
+   */
+  fileName: string;
+
+  /**
+   * The binary content of this attachment.
+   * 
+   * ---
+   * 
+   * You can select a method to handle this content:
+   * 
+   * @see [Uint8Array - JavaScript | MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array)
+   * 
+   * ```js
+   * // Node.js ≧ v25
+   * attachment.content.toBase64()
+   * ```
+   * 
+   * @see [Buffer | Node.js v25.2.1 Documentation](https://nodejs.org/api/buffer.html)
+   * 
+   * ```js
+   * // Node.js ≧ v0.1.90
+   * Buffer.from(attachment.content).toString('base64')
+   * ```
+   * 
+   * ---
+   */
+  content: Uint8Array;
+}
+
 /**
  * The core implementation of MsgReader
  */
@@ -1895,11 +1934,12 @@ export default class MsgReader {
   }
 
   /**
-   Reads an attachment content by key/ID
-   
-    @return {Object} The attachment for specific attachment key
-    */
-  getAttachment(attach: number | FieldsData): { fileName: string; content: Uint8Array } {
+   * Reads an attachment content by key/ID
+   * 
+   * @param attach 
+   * @returns The attachment for specific attachment key
+   */
+  getAttachment(attach: number | FieldsData): AttachmentData {
     const attachData = typeof attach === 'number' ? this.fieldsData.attachments[attach] : attach;
     if (attachData.innerMsgContent === true && typeof attachData.folderId === "number") {
       // embedded msg