Word Add-in开发：无法将Word文档内容赋值给JS全局变量

I’ve run into this exact issue before when working with Word documents and JavaScript—let’s break down the most common causes and how to fix them step by step.

1. You’re Ignoring Asynchronous Operations (The #1 Culprit) #

Most ways to access Word document content (whether via Office.js for Word Add-ins or parsing local files) are asynchronous. If you try to assign the content immediately without waiting for the async operation to finish, you’ll end up with a Promise or undefined instead of the actual text.

Wrong Example (Timing Issue) #

// Global variable
let wordContent;

// This fails because getText() is async—you're assigning a Promise, not the content
wordContent = Word.run(context => {
  return context.document.body.getText();
});

console.log(wordContent); // Logs a Promise, not your document text

Correct Example (Using Async/Await) #

For Office.js, wrap your code in Word.run() and use await to ensure you have the content before assigning it to your global variable:

// Declare global variable outside all functions
let globalWordContent;

async function fetchWordData() {
  try {
    await Word.run(async (context) => {
      // Get the body text and load it into the context
      const bodyText = context.document.body.getText();
      context.load(bodyText);
      
      // Wait for the sync to complete
      await context.sync();
      
      // Assign the actual content to your global variable
      globalWordContent = bodyText.value;
      console.log("Content saved to global variable:", globalWordContent);
    });
  } catch (error) {
    console.error("Failed to fetch Word content:", error);
  }
}

// Trigger the fetch when your app is ready
fetchWordData();

2. Your Variable Isn’t Actually Global #

If you declare your variable inside a function or module, it won’t be accessible globally. Double-check where you’re defining it:

Correct Global Declaration #

// Declare outside all functions/blocks to make it global
let globalWordContent;

function someFunction() {
  // Assign to the global variable from anywhere
  globalWordContent = "Fetched document content here";
}

For ES Modules (If You’re Using import/export) #

Modules have their own scope, so attach the variable to the window object to make it global:

// Inside your module
window.globalWordContent = bodyText.value;

3. You’re Parsing Local Word Files Incorrectly #

If you’re reading a local .docx file in the browser (not using Office.js), raw FileReader can’t parse the OOXML format directly. Use a library like mammoth.js to extract text, and again, handle the async flow properly:

let globalWordContent;

// Add a file input to your HTML: <input type="file" id="wordFileInput">
document.getElementById('wordFileInput').addEventListener('change', async (e) => {
  const file = e.target.files[0];
  if (!file) return;

  const reader = new FileReader();
  reader.onload = async (event) => {
    try {
      // Use mammoth to extract text from the .docx array buffer
      const result = await mammoth.extractRawText({ arrayBuffer: event.target.result });
      globalWordContent = result.value;
      console.log("Global variable updated:", globalWordContent);
    } catch (error) {
      console.error("Error parsing Word file:", error);
    }
  };
  reader.readAsArrayBuffer(file);
});

Quick Troubleshooting Checklist #

• Did you await all async operations before assigning the content?
• Is your variable declared outside of all functions/modules?
• Are you using the correct method to access the Word document (e.g., context.sync() for Office.js, mammoth.js for local files)?
• Check the browser console for hidden errors that might be blocking the assignment.

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