Является ли документация ColdFusion isSafeHTML() неправильной везде?

Question

Я пытался использовать isSafeHTML() сообщить пользователям, разрешен ли предоставленный ими HTML-код или нет. Документация на CFDocs.org и Adobe.com показывает, что для этой функции требуется три параметра: inputString, policyFile, throwOnError, Однако, когда я предоставляю все три параметра, я получаю сообщение об ошибке, в котором говорится, что он принимает только 1 или 2 параметра.

После некоторых испытаний я пришел к выводу, что throwOnError не является допустимым параметром для этой функции. Кто-нибудь еще может это подтвердить? Если так, есть ли способ обновить документацию, чтобы другие не столкнулись с той же проблемой?

Answer 1

Вы правы, я только что проверил его на ColdFusion 2016, обновление 2 (2016,0,02,299200) и выкинуло:

Ошибка проверки параметров для функции ISSAFEHTML. Функция принимает от 1 до 2 параметров.

Используя этот код:

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

Я обновил сайт cfdocs.org, чтобы удалить throwOnError аргумент. Для дальнейшего использования вы можете исправить документы на cfdocs.org, нажав на кнопку "Изменить", или, если вы просто хотите указать на проблему, вы можете нажать на кнопку "Проблема".

Для документов Adobe вы можете отправить отчет об ошибке здесь: https://bugbase.adobe.com/