*** Keywords ***

Open Login Page

    Open Browser    http://host/login.html

    Title Should Be    Login Page

Title Should Start With

    [Arguments]    ${expected}

    ${title} =    Get Title

    Should Start With    ${title}    ${expected}

*** Keywords ***

One Argument

    [Arguments]    ${arg_name}

    Log    Got argument ${arg_name}

Three Arguments

    [Arguments]    ${arg1}    ${arg2}    ${arg3}

    Log    1st argument: ${arg1}

    Log    2nd argument: ${arg2}

    Log    3rd argument: ${arg3}

请注意

默认值是空间敏感的语法。 空间 之前 = 不允许,和可能的空间 后被认为是默认值本身的一部分。

*** Keywords ***

One Argument With Default Value

    [Arguments]    ${arg}=default value

    [Documentation]    This keyword takes 0-1 arguments

    Log    Got argument ${arg}

Two Arguments With Defaults

    [Arguments]    ${arg1}=default 1    ${arg2}=${VARIABLE}

    [Documentation]    This keyword takes 0-2 arguments

    Log    1st argument ${arg1}

    Log    2nd argument ${arg2}

One Required And One With Default

    [Arguments]    ${required}    ${optional}=default

    [Documentation]    This keyword takes 1-2 arguments

    Log    Required: ${required}

    Log    Optional: ${optional}

 Default Based On Earlier Argument

    [Arguments]    ${a}    ${b}=${a}    ${c}=${a} and ${b}

    Should Be Equal    ${a}    ${b}

    Should Be Equal    ${c}    ${a} and ${b}

*** Test Cases ***

Example

    Two Arguments With Defaults    arg2=new value

*** Keywords ***

Any Number Of Arguments

    [Arguments]    @{varargs}

    Log Many    @{varargs}

One Or More Arguments

    [Arguments]    ${required}    @{rest}

    Log Many    ${required}    @{rest}

Required, Default, Varargs

    [Arguments]    ${req}    ${opt}=42    @{others}

    Log    Required: ${req}

    Log    Optional: ${opt}

    Log    Others:

    : FOR    ${item}    IN    @{others}

    \    Log    ${item}

*** Keywords ***

Kwargs Only

    [Arguments]    &{kwargs}

    Log    ${kwargs}

    Log Many    @{kwargs}

Positional And Kwargs

    [Arguments]    ${required}    &{extra}

    Log Many    ${required}    @{extra}

Run Program

    [Arguments]    @{varargs}    &{kwargs}

    Run Process    program.py    @{varargs}    &{kwargs}

*** Keywords ***

Select ${animal} from list

    Open Page    Pet Selection

    Select Item From List    animal_list    ${animal}

*** Test Cases ***

Example

    I execute "ls"

    I execute "ls" with "-lh"

*** Keywords ***

I execute "${cmd}"

    Run Process    ${cmd}    shell=True

I execute "${cmd}" with "${opts}"

    Run Process    ${cmd} ${opts}    shell=True

*** Test Cases ***

Example

    I execute "ls"

    I execute "ls" with "-lh"

    I type 1 + 2

    I type 53 - 11

    Today is 2011-06-27

*** Keywords ***

I execute "${cmd:[^"]+}"

    Run Process    ${cmd}    shell=True

I execute "${cmd}" with "${opts}"

    Run Process    ${cmd} ${opts}    shell=True

I type ${a:\d+} ${operator:[+-]} ${b:\d+}

    Calculate    ${a}    ${operator}    ${b}

Today is ${date:\d{4\}-\d{2\}-\d{2\}}

    Log    ${date}

提示

如果你引用参数,使用正则表达式 [^ "]+ 直到第一个保证的参数匹配 关闭报价。

支持正则表达式语法

使用Python实现,自然使用Python的机器人框架 再保险 非常标准的模块 正则表达式 语法 。 这个语法与嵌入式否则完全支持 参数,但regexp扩展格式 (?…) 不能 使用。 还需要注意的是,嵌入参数进行匹配 不区分大小写。 如果正则表达式语法无效, 创建关键字失败与错误中可见 测试执行 错误 。

转义特殊字符

有一些特殊字符需要使用时逃走了 自定义正则表达式嵌入参数。 首先,可能关闭 花括号( } )的模式需要保住了一个反斜杠 ( \ } ),否则参数就会结束了。 这是 与关键字前面的示例中所示 今天是$ {日期:\ d { 4 \ } - \ d { 2 \ } \ d { 2 \ } } 。

反斜杠( \ )是一种特殊的字符在Python中常规 表达式语法,因此需要逃脱了如果你想要一个 文字反斜杠字符。 在这种情况下最安全的转义序列 是四个反斜杠( \ \ \ \ ),但是,这取决于下一个 性格,还两个反斜杠可能就足够了。

注意到关键字名称和可能的嵌入参数 应该 不 使用正常的逃脱了 测试数据泄漏 规则 。 这意味着,例如,反斜杠的表达式 就像 $ {名称:\ w + } 不应该逃跑。

使用自定义的变量嵌入参数正则表达式

每当定制的嵌入式参数使用正则表达式时,机器人 框架会自动提高指定的regexp,这样他们 匹配变量除了与模式相匹配的文本。 这 意味着它总是可以用关键字使用变量 嵌入参数。 例如,下面的测试用例能通过 从早期的例子使用关键词。

*** Variables ***

${DATE}    2011-06-27

*** Test Cases ***

Example

    I type ${1} + ${2}

    Today is ${DATE}

一个缺点的变量自动定制正则匹配 表达式是可能值的关键字 实际上并没有匹配指定的正则表达式。 例如,变量 $ {日期} 在上面的例子中可以包含任何价值 今天是$ {日期} 仍将匹配相同的关键字。

*** Test Cases ***

Add two numbers

    Given I have Calculator open

    When I add 2 and 40

    Then result should be 42

Add negative numbers

    Given I have Calculator open

    When I add 1 and -2

    Then result should be -1

*** Keywords ***

I have ${program} open

    Start Program    ${program}

I add ${number 1} and ${number 2}

    Input Number    ${number 1}

    Push Button     +

    Input Number    ${number 2}

    Push Button     =

Result should be ${expected}

    ${result} =    Get Result

    Should Be Equal    ${result}    ${expected}

请注意

在机器人框架受嵌入参数特性 如何 步骤定义 中创建一个受欢迎的BDD工具。

*** Test Cases ***

One Return Value

    ${ret} =    Return One Value    argument

    Some Keyword    ${ret}

Multiple Values

    ${a}    ${b}    ${c} =    Return Three Values

    @{list} =    Return Three Values

    ${scalar}    @{rest} =    Return Three Values

*** Keywords ***

Return One Value

    [Arguments]    ${arg}

    Do Something    ${arg}

    ${value} =    Get Some Value

    [Return]    ${value}

Return Three Values

    [Return]    foo    bar    zap

*** Test Cases ***

One Return Value

    ${ret} =    Return One Value  argument

    Some Keyword    ${ret}

Advanced

    @{list} =    Create List    foo    baz

    ${index} =    Find Index    baz    @{list}

    Should Be Equal    ${index}    ${1}

    ${index} =    Find Index    non existing    @{list}

    Should Be Equal    ${index}    ${-1}

*** Keywords ***

Return One Value

    [Arguments]    ${arg}

    Do Something    ${arg}

    ${value} =    Get Some Value

    Return From Keyword    ${value}

    Fail    This is not executed

Find Index

    [Arguments]    ${element}    @{items}

    ${index} =    Set Variable    ${0}

    :FOR    ${item}    IN    @{items}

    \    Return From Keyword If    '${item}' == '${element}'    ${index}

    \    ${index} =    Set Variable    ${index + 1}

    Return From Keyword    ${-1}    # Could also use [Return]

请注意

这两个 从关键字 和 从关键字如果回来 因为机器人框架2.8。