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

Question

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

Answer 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”，无论如何......因为它可能在任何地方都没有可靠的可用性（或者至少，团队尚未签署它已完成并且可用）。因此，对于这些预览API，它实际上只适用于您自己的开发测试，而不是您在生产中使用的任何内容。