Word 插件 - 如何检查 createDocument() 函数是否可用?

Word Addin - how to check if the createDocument() function is available?

我正在使用 Office JS 开发 Word 插件。

感谢之前的回答,我发现我可以通过以下方式在 Word 中打开一个新文档:

context.application.createDocument().open();

不过,这似乎只适用于桌面版 Office。

如果我在在线版本中尝试相同的插件,我会收到错误消息:

Sorry, this function isn’t available. Perform a runtime check on the Office add-in to find out whether the feature is supported by the host

我如何以编程方式查明该功能是否可用,以便我可以使插件默认为不同的行为(如果不可用)?

此外,是否有一些关于 createDocument 函数的文档? (我用谷歌搜索但找不到任何东西)。

在一般情况下,您应该在运行时使用 isSetSupported API 检查以查看特定方法是否可用。参见 https://dev.office.com/docs/add-ins/develop/office-js-versioning

在这种特殊情况下,您 运行 了解 createDocument 是尚未发布(仅预览)WordApi 1.4 (PREVIEW) API 设置(您可以在 d.ts 文件 (TypeScript) 和 vsdoc(VS 2015 及更早版本中的 JavaScript)的 IntelliSense 中看到它。例如,在 https://github.com/OfficeDev/office-js/blob/beta/dist/office.d.ts

因为它是预览版,不幸的是,这意味着 isSetSupported 将 return "false" 无论如何......因为它可能无法在任何地方可靠地使用(或者至少,团队尚未签署它正在完成和可用)。因此,对于这些预览版 API,它实际上仅用于您自己的开发测试,而不是您在生产中使用的任何东西。