ColdFusion 的 isSafeHTML() 文档到处都是错误的吗?

Is ColdFusion's isSafeHTML() documentation wrong everywhere?

我一直在尝试使用isSafeHTML()来告诉用户是否允许他们提交的HTML。 CFDocs.org and Adobe.com 处的文档显示该函数需要三个参数:inputString, policyFile, throwOnError。但是,当我提供所有三个参数时,我收到一条错误消息,指出它只接受 1 或 2 个参数。

经过一些测试,我得出的结论是 throwOnError 不是该函数的有效参数。其他人可以证实这一点吗?如果是这样,有什么方法可以更新文档,以免其他人 运行 遇到同样的问题?

你是对的,我刚刚在 ColdFusion 2016 更新 2 (2016,0,02,299200) 上测试了它,它抛出了:

Parameter validation error for the ISSAFEHTML function. The function accepts 1 to 2 parameters.

使用此代码:

<cfoutput>
#isSafeHTML("html", server.coldfusion.rootdir & "/lib/antisamy-basic.xml", true)#
</cfoutput>

我更新了 cfdocs.org 站点以删除 throwOnError 参数。为了将来参考,您可以通过单击“编辑”按钮修复 cfdocs.org 上的文档,或者如果您只想指出一个问题,您可以单击“问题”按钮。

对于 Adob​​e 文档,您可以在此处提交错误报告:https://bugbase.adobe.com/