用户关键字的名称和文档

用户关键字的名称在关键字表格的第一列中定义. 当然, 关键字的名称应该具备描述性, 使用很长的关键字名称也是可以的. 实际上, 当创建用户场景类(use-case-like)的测试用例时, 所使用的高层关键字往往看起来就像是句子甚至段落.

用户关键字的文档通过 [Documentation] 设置, 这点和 测试用例名称和文档 完全一样. 文档在测试数据中设置, 但是一般在更正式的关键字文档中显示, 这个文档由 Libdoc_ 工具从 资源文件 中读取. 最后, 文档内容的第一行会作为关键字的文档在 test logs 中显示.

有时候关键字由于某种原因需要移出, 或者被新的替换, 或者被弃用. 在关键字文档的开始部分使用 DEPRECATED 可以标记该用户关键字已经不建议使用, 如果使用则会触发一个警告. 更多的说明请参见 Deprecating keywords .