1.2 Robot Framework基礎關鍵字

1.2.1 如何搜索Robot Framework的關鍵字

有兩種方式可以快速地打開RIDE的關鍵字搜索對話框。

（1）選擇菜單欄中的Tools→Search Keywords選項，然后會出現如圖1-2-1所示的關鍵字搜索對話框，這個對話框就類似于提供了一個關鍵字的API功能（提供了關鍵字的名稱、關鍵字的來源庫、關鍵字的使用描述和關鍵字的參數）。

圖 1-2-1

（2）直接按F5快捷鍵，就可以自動彈出我們需要的關鍵字搜索框。

1.2.2 關鍵字log

Log關鍵字其實就等同于Python語言中的print函數，可以輸出我們想要輸出的內容（也就是我們在編程語言中常說的日志輸出），比如我們在test case中輸入如圖1-2-2所示的內容。

圖 1-2-2

勾選我們的測試用例，單擊菜單欄Tools→Run Tests（或者直接快捷鍵F8）來執行這條測試用例，如圖1-2-3所示。

圖 1-2-3

執行完成后，切換到Run標簽，可以看到用例執行的結果。通過運行結果可以看到輸出了我們想要輸出的信息INFO : Hello RobotFramework，如圖1-2-4所示。

圖 1-2-4

1.2.3 如何在用例中定義一個變量

我們可以通過Set Variable來定義一個變量，比如我們定義一個變量var1，并且將這個變量賦值為Robot，然后將這個變量用log輸出，如圖1-2-5所示。

圖 1-2-5

執行結果如圖1-2-6所示。

圖 1-2-6

1.2.4 如何快速查詢某一個關鍵字的API說明

選中關鍵字，同時按住Ctrl+Alt組合鍵，即可顯示該關鍵字的幫助API以及使用示例，如圖1-2-7所示。

圖 1-2-7

1.2.5 如何快速補全關鍵字

通過鍵盤輸入關鍵字的前綴，然后同時按住Ctrl+Alt+空格鍵，即可快速補全某個關鍵字，如圖1-2-8所示。

圖 1-2-8

1.2.6 如何定義一個列表

此處我們說的列表，其實就等同于Python語言中的列表，是Python語言中常用的一種數據結構，也類似于Java語言中的List。

在Robot Framework中，我們可以使用Create List來創建一個列表，比如我們定義一個列表list1，并且在創建列表時就添加3個元素。然后使用log關鍵字將這個列表中的元素全部輸出，如圖1-2-9所示。

圖 1-2-9

執行結果如圖1-2-10所示。

圖 1-2-10

1.2.7 如何定義一個字典

此處我們說的字典其實就等同于Python語言中的字典，和列表一樣，字典也是Python語言中非常常用的一種數據結構，也類似于Java語言中的Map。

在Robot Framework中，使用Create Dictionary來創建一個字典，比如我們定義一個字典Dict1，并且在創建字典時就添加兩個鍵值對，然后使用Log Many關鍵字將這個字典中的內容全部輸出，如圖1-2-11所示。

Log Many關鍵字類似于log關鍵字，不同的是log關鍵字只可以接收一個參數，而Log Many關鍵字可以同時接收多個參數。

圖 1-2-11

執行結果如圖1-2-12所示。

圖 1-2-12

1.2.8 如何拼接兩個字符串

我們可以通過Catenate來拼接字符串，比如將“Hello”和“Robot”這兩個字符串拼接起來并且輸出，如圖1-2-13所示。

圖 1-2-13

執行結果如圖1-2-14所示。

圖 1-2-14

1.2.9 如何使用for循環

不管在哪種編程語言中，for循環都是必不可少的。在Robot Framework中，我們也可以使用for循環來做遍歷處理。

我們可以用for循環對一個列表進行遍歷，并且輸出該列表中的每一個元素。例如，list2中有a、b、c、d四個元素，循環遍歷輸出這些元素，如圖1-2-15所示。

圖 1-2-15

執行結果如圖1-2-16所示。

圖 1-2-16

1.2.10 如何中斷for循環

我們可以使用Exit For Loop If關鍵字來中斷一個for循環。例如，list2有a、b、c、d四個元素，循環遍歷輸出這些元素，當輸出到元素c時跳出這個循環，如圖1-2-17所示。

圖 1-2-17

執行結果如圖1-2-18所示。

圖 1-2-18

1.2.11 Run Keyword If判斷的使用

Run Keyword If是一個常用的用來做邏輯判斷的關鍵字，意思是如果滿足了某一個判斷條件，就會執行關鍵字。我們在list3中放入0、1、2三個元素，然后遍歷list3，判斷當取到元素0時，輸出“男生”，如圖1-2-19所示。

圖 1-2-19

執行結果如圖1-2-20所示。

圖 1-2-20

1.2.12 Comment關鍵字的使用

Comment關鍵字是用來做注釋使用的，和很多編程語言中的注釋作用一樣，可以用來臨時注釋掉某一行自動化腳本，讓其暫時不運行，也可以用來做解釋說明使用，如圖1-2-21所示。

在Robot Framework的RIDE中，可以選中某一行腳本，右擊鼠標鍵，選擇Comment Rows選項，然后可以對選中的那一行腳本做注釋，注釋完成后，這一行腳本將不會再被運行。

圖 1-2-21

Comment   log "Comment"

如果需要取消注釋，右擊鼠標鍵，選擇Uncomment Rows選項即可。注釋取消后，在用例運行時，沒有被注釋的腳本就會被運行，如圖1-2-22所示。

圖 1-2-22

1.2.13 Return From Keyword和Return From Keyword If關鍵字的使用

Return From Keyword關鍵字和很多編程語言中的return關鍵字一樣，具有如下鮮明的特點：

（1）腳本執行到該關鍵字后，會直接返回，不會再執行后面的腳本。

（2）返回時會帶有對應返回值。調用者可以通過不同的返回值來建立不同的判斷分支。

（3）Return From Keyword關鍵字一般用于用戶自定義關鍵字中。用戶自定義關鍵字相當于是用系統已有的關鍵字來封裝出一個新的關鍵字。

（4）Return From Keyword If關鍵字用if條件來進行判斷，當滿足指定的if條件后，就執行return返回。返回時和Return From Keyword關鍵字一樣，可以指定返回的具體值。

【示例】我們編寫了一個自定義關鍵字，其中定義了一個入參${valueReturn}，如圖1-2-23所示，然后通過執行Return From Keyword If '${value}'=='${valueReturn}' ${value} 來判斷我們需要返回的值，如圖1-2-24所示。

圖 1-2-23

圖 1-2-24

自定義關鍵字完成后，就可以調用了，如圖1-2-25所示。

圖 1-2-25

執行結果如圖1-2-26所示。

圖 1-2-26

從執行結果可以看到，在調用Example Return From Keyword這個自定義關鍵字時，我們傳入的入參為4，按照自定義關鍵字中的判斷邏輯返回4。