JMeter ----内置函数列表
Jmeter有两种类型的函数:
-
用户定义的静态值(或变量)
-
内置函数
用户定义的静态值允许用户定义变量时被替换为静态的值测试树编译并提交运行。需要注意的是,变量目前无法嵌套,即${Var${N}}不起作用
__ V(变量)函数(版本2.2后)可用于执行此操作: ${__V(Var${N})}. 这种类型的替换可能没有函数,但更方便,更直观
函数和变量可以在哪里使用?
函数和变量可以被写入到任何领域的任何测试部件。
下面的函数测试计划应确定工作:
-
intSum
-
longSum
-
machineName
-
BeanShell
-
javaScript
-
jexl
-
random
-
time
-
property functions
-
log functions
测试计划使用的功能有一些限制。JMeter的线程变量没有被完全成立处理功能时,不会设置变量名作为参数传递,将无法正常工作和变量引用,所以split() 和 regex() 变量赋值函数不会工作。 threadNum() 函数将不能工作
引用变量及函数
引用的变量中的测试元件是通过包围在变量名 '${' and '}'.
函数中引用同样的方式,但按照惯例,函数的名称以“__”开头,以避免冲突与用户值的名称
有些函数带参数的配置,而这些括号中,逗号分隔。如果函数没有参数,括号可以省略。对于例如:
${__BeanShell(vars.put("name","value"))}
另外,可以定义你的脚本作为一个变量,例如测试计划:
SCRIPT vars.put("name","value")
然后,该脚本可以被引用如下:
${__BeanShell(${SCRIPT})}
预定义变量
JMeter 内部定义的一些变量。它们分别是:
-
COOKIE_cookiename - 包含cookie的值
-
JMeterThread.last_sample_ok - 与否的最后一个样本是确定的 - true/false。注:这是更新后的后处理和断言已经运行。
-
START 变量
预先定义的特性
一些内置的的属性定义JMeter。下面列出了这些。为方便起见,启动的属性也被复制到具有相同名称的变量。
-
START.MS - JMeter 启动时间(毫秒)
-
START.YMD - JMeter 启动时间为 yyyyMMdd
-
START.HMS - JMeter 启动时间为 HHmmss
-
TESTSTART.MS - 测试开始时间(毫秒)
请注意,开始变量/属性代表 JMeter 的启动时间,而不是测试开始时间。它们主要适用于使用文件名等。
表11-1 JMeter内置函数列表
函数类型 | 名称 | 注释 |
---|---|---|
Information | threadNum | get thread number |
Information | samplerName | get the sampler name (label) |
Information | machineIP | get the local machine IP address |
Information | machineName | get the local machine name |
Information | time | return current time in various formats |
Information | log | log (or display) a message (and return the value) |
Information | logn | log (or display) a message (empty return value) |
Input | StringFromFile | read a line from a file |
Input | FileToString | read an entire file |
Input | CSVRead | read from CSV delimited file |
Input | XPath | Use an XPath expression to read from a file |
Calculation | counter | generate an incrementing number |
Calculation | intSum | add int numbers |
Calculation | longSum | add long numbers |
Calculation | Random | generate a random number |
Calculation | RandomString | generate a random string |
Calculation | UUID | generate a random type 4 UUID |
Scripting | BeanShell | run a BeanShell script |
Scripting | javaScript | process JavaScript (Mozilla Rhino) |
Scripting | jexl, jexl2 | evaluate a Commons Jexl expression |
Properties | property | read a property |
Properties | P | read a property (shorthand method) |
Properties | setProperty | set a JMeter property |
Variables | split | Split a string into variables |
Variables | V | evaluate a variable name |
Variables | eval | evaluate a variable expression |
Variables | evalVar | evaluate an expression stored in a variable |
String | regexFunction | parse previous response using a regular expression |
String | escapeOroRegexpChars | quote meta chars used by ORO regular expression |
String | char | generate Unicode char values from a list of numbers |
String | unescape | Process strings containing Java escapes (e.g. & ) |
String | unescapeHtml | Decode HTML-encoded strings |
String | escapeHtml | Encode strings using HTML encoding |
String | TestPlanName | Return name of current test plan |