[api-minor] Improve the FileSpec implementation

- Check that the `filename` is actually a string, before parsing it further.
 - Use proper "shadowing" in the `filename` getter.
 - Add a bit more validation of the data in `pickPlatformItem`.
 - Last, but not least, return both the original `filename` and the (path stripped) variant needed in the display-layer and viewer.

src/core/catalog.js

@@ -1619,8 +1619,8 @@ class Catalog {
               /* xref = */ null,
               /* skipContent = */ true
             );
-            const { filename } = fs.serializable;
+            const { rawFilename } = fs.serializable;
-            url = filename;
+            url = rawFilename;
           } else if (typeof urlDict === "string") {
             url = urlDict;
           }

src/core/file_spec.js

@@ -18,6 +18,9 @@ import { BaseStream } from "./base_stream.js";
 import { Dict } from "./primitives.js";
 
 function pickPlatformItem(dict) {
+  if (!(dict instanceof Dict)) {
+    return null;
+  }
   // Look for the filename in this order:
   // UF, F, Unix, Mac, DOS
   if (dict.has("UF")) {
@@ -34,6 +37,10 @@ function pickPlatformItem(dict) {
   return null;
 }
 
+function stripPath(str) {
+  return str.substring(str.lastIndexOf("/") + 1);
+}
+
 /**
  * "A PDF file can refer to the contents of another file by using a File
  * Specification (PDF 1.1)", see the spec (7.11) for more details.
@@ -66,26 +73,27 @@ class FileSpec {
   }
 
   get filename() {
-    if (!this._filename && this.root) {
+    let filename = "";
-      const filename = pickPlatformItem(this.root) || "unnamed";
+
-      this._filename = stringToPDFString(filename)
+    const item = pickPlatformItem(this.root);
+    if (item && typeof item === "string") {
+      filename = stringToPDFString(item)
         .replaceAll("\\\\", "\\")
         .replaceAll("\\/", "/")
         .replaceAll("\\", "/");
     }
-    return this._filename;
+    return shadow(this, "filename", filename || "unnamed");
   }
 
   get content() {
     if (!this.#contentAvailable) {
       return null;
     }
-    if (!this.contentRef && this.root) {
+    this._contentRef ||= pickPlatformItem(this.root?.get("EF"));
-      this.contentRef = pickPlatformItem(this.root.get("EF"));
+
-    }
     let content = null;
-    if (this.contentRef) {
+    if (this._contentRef) {
-      const fileObj = this.xref.fetchIfRef(this.contentRef);
+      const fileObj = this.xref.fetchIfRef(this._contentRef);
       if (fileObj instanceof BaseStream) {
         content = fileObj.getBytes();
       } else {
@@ -94,7 +102,7 @@ class FileSpec {
         );
       }
     } else {
-      warn("Embedded file specification does not have a content");
+      warn("Embedded file specification does not have any content");
     }
     return content;
   }
@@ -111,7 +119,8 @@ class FileSpec {
 
   get serializable() {
     return {
-      filename: this.filename,
+      rawFilename: this.filename,
+      filename: stripPath(this.filename),
       content: this.content,
       description: this.description,
     };

src/display/annotation_layer.js

@@ -37,7 +37,6 @@ import {
 } from "../shared/util.js";
 import {
   DOMSVGFactory,
-  getFilenameFromUrl,
   PDFDateString,
   setLayerDimensions,
 } from "./display_utils.js";
@@ -2859,15 +2858,13 @@ class FileAttachmentAnnotationElement extends AnnotationElement {
   constructor(parameters) {
     super(parameters, { isRenderable: true });
 
-    const { filename, content, description } = this.data.file;
+    const { file } = this.data;
-    this.filename = getFilenameFromUrl(filename, /* onlyStripPath = */ true);
+    this.filename = file.filename;
-    this.content = content;
+    this.content = file.content;
 
     this.linkService.eventBus?.dispatch("fileattachmentannotation", {
       source: this,
-      filename,
+      ...file,
-      content,
-      description,
     });
   }
 

test/unit/annotation_spec.js

@@ -4033,9 +4033,12 @@ describe("annotation", function () {
         idFactoryMock
       );
       expect(data.annotationType).toEqual(AnnotationType.FILEATTACHMENT);
-      expect(data.file.filename).toEqual("Test.txt");
+      expect(data.file).toEqual({
-      expect(data.file.content).toEqual(stringToBytes("Test attachment"));
+        rawFilename: "Test.txt",
-      expect(data.file.description).toEqual("abc");
+        filename: "Test.txt",
+        content: stringToBytes("Test attachment"),
+        description: "abc",
+      });
     });
   });
 

test/unit/api_spec.js

@@ -1475,12 +1475,12 @@ describe("api", function () {
       const pdfDoc = await loadingTask.promise;
       const attachments = await pdfDoc.getAttachments();
 
-      const { filename, content, description } = attachments["foo.txt"];
+      expect(attachments["foo.txt"]).toEqual({
-      expect(filename).toEqual("foo.txt");
+        rawFilename: "foo.txt",
-      expect(content).toEqual(
+        filename: "foo.txt",
-        new Uint8Array([98, 97, 114, 32, 98, 97, 122, 32, 10])
+        content: new Uint8Array([98, 97, 114, 32, 98, 97, 122, 32, 10]),
-      );
+        description: "",
-      expect(description).toEqual("");
+      });
 
       await loadingTask.destroy();
     });
@@ -1490,7 +1490,9 @@ describe("api", function () {
       const pdfDoc = await loadingTask.promise;
       const attachments = await pdfDoc.getAttachments();
 
-      const { filename, content, description } = attachments["empty.pdf"];
+      const { rawFilename, filename, content, description } =
+        attachments["empty.pdf"];
+      expect(rawFilename).toEqual("Empty page.pdf");
       expect(filename).toEqual("Empty page.pdf");
       expect(content instanceof Uint8Array).toEqual(true);
       expect(content.length).toEqual(2357);

web/pdf_attachment_viewer.js

@@ -18,7 +18,6 @@
 /** @typedef {import("./download_manager.js").DownloadManager} DownloadManager */
 
 import { BaseTreeViewer } from "./base_tree_viewer.js";
-import { getFilenameFromUrl } from "pdfjs-lib";
 import { waitOnEventOrTimeout } from "./event_utils.js";
 
 /**
@@ -122,19 +121,13 @@ class PDFAttachmentViewer extends BaseTreeViewer {
     let attachmentsCount = 0;
     for (const name in attachments) {
       const item = attachments[name];
-      const content = item.content,
-        description = item.description,
-        filename = getFilenameFromUrl(
-          item.filename,
-          /* onlyStripPath = */ true
-        );
 
       const div = document.createElement("div");
       div.className = "treeItem";
 
       const element = document.createElement("a");
-      this._bindLink(element, { content, description, filename });
+      this._bindLink(element, item);
-      element.textContent = this._normalizeTextContent(filename);
+      element.textContent = this._normalizeTextContent(item.filename);
 
       div.append(element);
 
@@ -148,7 +141,7 @@ class PDFAttachmentViewer extends BaseTreeViewer {
   /**
    * Used to append FileAttachment annotations to the sidebar.
    */
-  #appendAttachment({ filename, content, description }) {
+  #appendAttachment(item) {
     const renderedPromise = this._renderedCapability.promise;
 
     renderedPromise.then(() => {
@@ -158,15 +151,12 @@ class PDFAttachmentViewer extends BaseTreeViewer {
       const attachments = this._attachments || Object.create(null);
 
       for (const name in attachments) {
-        if (filename === name) {
+        if (item.filename === name) {
           return; // Ignore the new attachment if it already exists.
         }
       }
-      attachments[filename] = {
+      attachments[item.filename] = item;
-        filename,
+
-        content,
-        description,
-      };
       this.render({
         attachments,
         keepRenderedCapability: true,