Word插件-如何检查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 check，以便能够查看特定方法是否可用。请参阅https://dev.office.com/docs/add-ins/develop/office-js-versioning

在这种情况下，你会遇到这样一个事实：createDocument是一个尚未发布的(仅限预览的) WordApi 1.4 (PREVIEW)应用程序接口集的一部分(你可以在IntelliSense中看到它，包括d.ts文件(TypeScript)和vsdoc (VS2015及更早版本中的JavaScript)。例如，在https://github.com/OfficeDev/office-js/blob/beta/dist/office.d.ts中

​

​

因为它是预览，这很不幸地意味着isSetSupported将返回"false“。因为它可能还不能可靠地在任何地方使用(或者至少，团队还没有签字确认它已经完成并可用)。因此，对于这些预览API，它实际上只是用于您自己的开发测试，而不是您将在生产中使用的任何东西。