Feat: add support for image title

lib/documents.js

@@ -152,6 +152,7 @@ function Image(options) {
     return {
         type: types.image,
         read: options.readImage,
+        title: options.title,
         altText: options.altText,
         contentType: options.contentType
     };

lib/docx/body-reader.js

@@ -461,12 +461,11 @@ function BodyReader(options) {
 
     function readBlip(element, blip) {
         var properties = element.first("wp:docPr").attributes;
-        var altText = isBlank(properties.descr) ? properties.title : properties.descr;
         var blipImageFile = findBlipImageFile(blip);
         if (blipImageFile === null) {
             return emptyResultWithMessages([warning("Could not find image file for a:blip element")]);
         } else {
-            return readImage(blipImageFile, altText);
+            return readImage(blipImageFile, properties.descr, properties.title);
         }
     }
 
@@ -510,12 +509,13 @@ function BodyReader(options) {
         };
     }
 
-    function readImage(imageFile, altText) {
+    function readImage(imageFile, altText, title) {
         var contentType = contentTypes.findContentType(imageFile.path);
 
         var image = documents.Image({
             readImage: imageFile.read,
-            altText: altText,
+            altText: isBlank(altText) ? title : altText,
+            title: title,
             contentType: contentType
         });
         var warnings = supportedImageTypes[contentType] ?

test/docx/body-reader.tests.js

@@ -987,13 +987,15 @@ test("when v:imagedata element has no relationship ID then it is ignored with wa
 test("can read inline pictures", function() {
     var drawing = createInlineImage({
         blip: createEmbeddedBlip(IMAGE_RELATIONSHIP_ID),
-        description: "It's a hat"
+        description: "It's a hat",
+        title: "Sombrero"
     });
 
     var result = readEmbeddedImage(drawing);
 
     return promiseThat(result, isSuccess(contains(isImage({
         altText: "It's a hat",
+        title: "Sombrero",
         contentType: "image/png",
         buffer: IMAGE_BUFFER
     }))));
@@ -1008,6 +1010,7 @@ test("alt text title is used if alt text description is missing", function() {
     var result = readEmbeddedImage(drawing);
 
     return promiseThat(result, isSuccess(contains(isImage({
+        title: "It's a hat",
         altText: "It's a hat"
     }))));
 });
@@ -1022,7 +1025,8 @@ test("alt text title is used if alt text description is blank", function() {
     var result = readEmbeddedImage(drawing);
 
     return promiseThat(result, isSuccess(contains(isImage({
-        altText: "It's a hat"
+        altText: "It's a hat",
+        title: "It's a hat"
     }))));
 });
 
@@ -1036,7 +1040,8 @@ test("alt text description is preferred to alt text title", function() {
     var result = readEmbeddedImage(drawing);
 
     return promiseThat(result, isSuccess(contains(isImage({
-        altText: "It's a hat"
+        altText: "It's a hat",
+        title: "hat"
     }))));
 });