Word Addin - 如何检查 createDocument() 函数是否可用？答案

【问题标题】：Word Addin - how to check if the createDocument() function is available?Word Addin - 如何检查 createDocument() 函数是否可用？
【发布时间】：2017-07-04 01:26:54
【问题描述】：

我正在使用 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 函数的文档？（我用谷歌搜索并找不到任何东西）。

【问题讨论】：

标签： ms-office office365 office-js office-addins

【解决方案1】：

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

在这种特殊情况下，您会遇到这样一个事实：createDocument 是尚未发布（仅限预览版）WordApi 1.4 (PREVIEW) API 集的一部分（您可以在 IntelliSense 中看到它，两者都在d.ts 文件（TypeScript）和 vsdoc（VS 2015 及更早版本中的 JavaScript）。例如，在 https://github.com/OfficeDev/office-js/blob/beta/dist/office.d.ts

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

【讨论】：