Katalon Studio上传文件

写在前面

最近有童鞋询问如何使用Katalon Studio上传文件,空闲时间研究了一下。

常见的上传文件一般有两种格式的html，首先简单介绍一下。

第一种：

input type = "file"

这种操作很简单,Katalon Studio本身有封装的关键字uploadFile()可以直接调用。

另外,这种类型的上传文件之前写过关于Selenium的操作,详情见文章：Selenium文件上传

第二种：

非input类型的上传文件格式，这种操作就麻烦点，需要单独封装关键字调用。

本文将针对Katalon Studio来讲解如何上传文件。

input类型的上传文件

为了更直观的演示处理效果，制作了一个上传文件的html。上传文件传送门： Upfile.html[请点点我]

html界面如下图所示：

准备工作：

计算机本地D盘根目录下新建一个txt文件,命名为:upload_file.txt,然后修改后缀名为:upload_file.png 由于html文件限制了上传文件的类型仅为：.jpg .png .jpeg .gif,并且限制了上传文件的大小，所以请按照指示建立upload_file.png。Katalon Studio在Script模式编写以下脚本：

import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
import com.kms.katalon.core.model.FailureHandling as FailureHandling
import com.kms.katalon.core.testcase.TestCase as TestCase
import com.kms.katalon.core.testdata.TestData as TestData
import com.kms.katalon.core.testobject.TestObject as TestObject
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import internal.GlobalVariable as GlobalVariable
import org.openqa.selenium.Keys as Keys

WebUI.openBrowser('https://www.testclass.cn/test_html/UpFile.html')

WebUI.uploadFile(findTestObject('Object Repository/upload'), 'D:\\upload_file.png')

执行结果如下所示：

非input类型的上传文件

针对一些非input格式的文件上传,或input格式使用上述方法执行无效,可以试试这部分的操作方法。

非input格式的前端应用界面如下图所示：

解决思路:

1.新建关键字

2.调用关键字

3.执行测试案例

关键字的建立不再详细说明。之前写过一篇文章，详情请见：Katalon Studio如何定义关键字

新建关键字的内容如下：

package testclass

import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject

import com.kms.katalon.core.annotation.Keyword
import com.kms.katalon.core.checkpoint.Checkpoint
import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
import com.kms.katalon.core.model.FailureHandling
import com.kms.katalon.core.testcase.TestCase
import com.kms.katalon.core.testdata.TestData
import com.kms.katalon.core.testobject.TestObject
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import java.awt.Robot
import java.awt.Toolkit
import java.awt.datatransfer.StringSelection
import java.awt.event.KeyEvent
import internal.GlobalVariable

public class cn {

	@Keyword
	def uploadFile (TestObject to, String filePath) {
		WebUI.click(to)
		StringSelection ss = new StringSelection(filePath);
		Toolkit.getDefaultToolkit().getSystemClipboard().setContents(ss, null);
		Robot robot = new Robot();
		robot.keyPress(KeyEvent.VK_ENTER);
		robot.keyRelease(KeyEvent.VK_ENTER);
		robot.keyPress(KeyEvent.VK_CONTROL);
		robot.keyPress(KeyEvent.VK_V);
		robot.keyRelease(KeyEvent.VK_V);
		robot.keyRelease(KeyEvent.VK_CONTROL);
		robot.keyPress(KeyEvent.VK_ENTER);
		robot.keyRelease(KeyEvent.VK_ENTER);
	}
}

备注：以上关键字也适用于input类型的文件上传。

建立完以上关键字以后，在Script模式调用：

CustomKeywords.'testclass.cn.uploadFile'(findTestObject('Object Repository/upload'), 'D:\\upload_file.png')

如果想试试效果,可以对我制作的input类型的HTML操作。上传文件传送门： Upfile.html[请点点我]

在Katalon Studio中新建测试案例，执行以下代码：

import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
import com.kms.katalon.core.model.FailureHandling as FailureHandling
import com.kms.katalon.core.testcase.TestCase as TestCase
import com.kms.katalon.core.testdata.TestData as TestData
import com.kms.katalon.core.testobject.TestObject as TestObject
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import internal.GlobalVariable as GlobalVariable
import org.openqa.selenium.Keys as Keys

WebUI.openBrowser('https://www.testclass.cn/test_html/UpFile.html')

CustomKeywords.'testclass.cn.uploadFile'(findTestObject('Object Repository/upload'), 'D:\\upload_file.png')

注意事项：

1.上传文件的路径需要填写绝对路径；

2.上传文件的路径需要双反斜杠“\\”,例如：'D:\\upload_file.png'；

3.上传文件的名称需要英文格式，并且带文件后缀名；

4.上传文件的路径中的文件夹都需要英文命名；

5.个人建议把需要上传的文件放到你所建立的项目文件中；

findTestObject('Object Repository/upload)

该部分findTestObject定位的元素为上图中的"选择文件"，需要正确的定位到该元素。

执行效果，如下图所示：