如何用OfficeJS提取PPT文本？遇RichApi.Error属性读取错误求解决

我正在开发一款Office Add-in，需要实现点击按钮自动提取PPT全部文本或当前幻灯片文本的功能。我是OfficeJS新手，未找到相关示例。我认为可行思路是遍历每张幻灯片、每个TextFrames并读取文本值，但在Office文档中未找到TextFrames的读取方法。目前仅能提取光标选中的文本，代码如下：

async function getSlideText() {
    Office.context.document.getSelectedDataAsync(Office.CoercionType.Text, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            setMessage("Error");
        } else {
            setMessage("Selected the following Text: " + asyncResult.value);
        }
    });
}

之后我尝试遍历幻灯片中的形状、textFrame和textRange，但访问textRange的text属性时出现错误，我的方法代码如下：

async function getParsedText() {
await PowerPoint.run(async (context) => {
    // Get the shapes from first slide of ppt
    const sheet = context.presentation.slides.getItemAt(0);
    const shapes = sheet.shapes;

    // Load all the shapes in the collection
    shapes.load();
    await context.sync();

    shapes.items.forEach(function (shape) { //for each shape get tf, tr, and txt
        if (shape.textFrame != null) {
            const tf = shape.textFrame;
            tf.load();

            if (tf != null) {
                console.log("tf is found");
            }
            else {
                console.log("tf is not found");
            }

            const tr = tf.textRange;
            tr.load();

            if (tr != null) {
                console.log("tr is found");
            }
            else {
                console.log("tr is not found");
            }

            
            const txt = tr.text;
            txt.load();
            if (txt != null) {
                console.log("txt is found");
            }
            else {
                console.log("txt is not found");
            }

            console.log("Text in shape: ", txt);

            context.sync();
        }
    });
    await context.sync();
});}

错误信息：

uncaught (in promise) RichApi.Error: The property 'text' is not available. Before reading the property's value, call the load method on the containing object and call "context.sync()" on the associated request context.

请问该如何解决这个问题？

你的问题核心是没掌握Office JS的异步加载规则：一是加载对象时没明确指定要读取的属性，导致text未被加载；二是错误地给字符串类型的tr.text调用load()方法，且循环内的context.sync()未正确等待。

以下是修正后的代码，分别实现两种提取需求：

提取当前幻灯片文本 #

async function getCurrentSlideText() {
    await PowerPoint.run(async (context) => {
        // 获取当前选中的幻灯片
        const currentSlide = context.presentation.getSelectedSlides().getItemAt(0);
        const shapes = currentSlide.shapes;
        
        // 批量加载所有需要的嵌套属性，减少sync次数
        shapes.load("items(textFrame/textRange/text)");
        await context.sync();

        let slideText = "";
        shapes.items.forEach(shape => {
            // 校验形状是否包含有效文本
            if (shape.textFrame && shape.textFrame.textRange && shape.textFrame.textRange.text) {
                slideText += shape.textFrame.textRange.text + "\n";
            }
        });

        console.log("当前幻灯片文本：", slideText);
        // 替换为你自己的文本展示逻辑，比如调用setMessage
        // setMessage(slideText);
    }).catch(error => {
        console.error("提取失败：", error);
        setMessage("提取文本失败");
    });
}

提取全部幻灯片文本 #

async function getAllSlidesText() {
    await PowerPoint.run(async (context) => {
        const slides = context.presentation.slides;
        // 批量加载所有幻灯片及对应形状的文本属性
        slides.load("items(shapes/items(textFrame/textRange/text))");
        await context.sync();

        let allText = "";
        slides.items.forEach((slide, index) => {
            allText += `=== 第${index+1}页 ===\n`;
            slide.shapes.items.forEach(shape => {
                if (shape.textFrame && shape.textFrame.textRange && shape.textFrame.textRange.text) {
                    allText += shape.textFrame.textRange.text + "\n";
                }
            });
            allText += "\n";
        });

        console.log("全部幻灯片文本：", allText);
        // setMessage(allText);
    }).catch(error => {
        console.error("提取失败：", error);
        setMessage("提取文本失败");
    });
}

关键修复说明 #

• 批量加载属性：用shapes.load("items(textFrame/textRange/text)")一次性加载嵌套属性，减少异步同步次数，提升性能
• 移除无效操作：tr.text是字符串类型，不需要调用load()，直接读取即可
• 优化异步流程：在PowerPoint.run中只做必要的context.sync()，避免循环内频繁同步
• 增加错误捕获：用.catch()捕获异步异常，防止程序崩溃

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