Word Addin - 如何检查createDocument（）函数是否可用？

Question

我使用Office JS开发Word插件。

由于以前的答案，我发现我可以做在Word中打开一个新的文档：

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

然而，这似乎只在办公室的桌面版本。

如果我尝试在网上版本相同的插件，我得到一个错误：

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函数的一些文档？ （我Google搜索，找不到任何东西）。

Answer 1

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

在这种特殊情况下，你正在运行到一个事实，即createDocument是尚未发布的（预览只）WordApi 1.4 (PREVIEW) API集的一部分（你可以看到它在智能感知，无论是在d .TS文件（打字稿）和vsdoc（在2015年VS JavaScript和更早的版本）。例如，在https://github.com/OfficeDev/office-js/blob/beta/dist/office.d.ts

因为它的预览，这个遗憾，这意味着isSetSupported将返回“假”不管......因为它可能在任何地方都没有可靠的可用性（或者至少，团队还没有签署完成并且可用）。所以对于这些预览API，这仅仅是为了你自己的开发测试，而不是你在生产中使用的任何东西。