Jmeter函数详解

参考文章：
【Jmeter】元件详解：函数助手 - [顾三殇]
https://blog.csdn.net/qq_39720249/article/details/88790042
jmeter官方文档
https://jmeter.apache.org/usermanual/functions.html#__log

BeanShell

对表达式求值并存储变量

${__BeanShell(1+1,var)}
输入：1+1
输出：var = 2

changeCase

对字符串进行格式化（UPPER（默认），LOWER，CAPITALIZE）

${__changeCase(aaaaa,CAPITALIZE,)}
输入：aaaaa
输出：Aaaaa

char

对Unicode 字符数（十进制或0xhex） 进行转换

${__char(69)}
输入：69
输出：E

counter

计数器，每次被调用都会产生一个新的数字，从1开始，每次加1

${__counter(,)}
输入：
输出：1

CSRead

读取外部文件指定列的参数

${__CSVRead(D:\JmeterData\he.txt,2)}
输入：1,2,3
输出：3

dateTimeConvert

格式化时间

${__dateTimeConvert(1620457371995,,yyyy-MM-dd HH:mm:ss,)}
输入：1620457371995
输出：2021-05-08 15:02:51

digest

返回指定哈希算法中的摘要值。(加密)

${__digest(MD5,Errare humanum est,,true,)}
输入：Errare humanum est
输出：C49F00B92667A35C63708933384DAD52
    
参数介绍：
摘要算法：MD2、MD5、SHA-1、SHA-224、SHA-256、SHA-384、SHA-512
String to be hashed：要计算的字符串；
Salt to be used for hashing (optional)：用于计算散列的盐（可选项）；
Upper case result, defaults to false (optional)：结果大写，默认为false（可选），即默认摘要值为小写
存储结果的变量名（可选）

escapeHtml

把字符转换成 Html 格式的字符

${__escapeHtml("")}
输入：“”
输出：""

escapeOroRegexpChars

把一些 Java 正则表达式引擎不识别的正则式转换一下，这样就可以识别了;

${__escapeOroRegexpChars([^"].+?,)}
输入：[^"].+?,
输出：\[\^\"\]\.\+\?\,

escapeXml

字符串转义

${__escapeXml("bread" & 'butter')}
输入："bread" & 'butter'
输出："bread" & 'butter'

eval

函数 __eval 可以用来执行一个字符串表达式，并返回执行结果。（该函数里面可以执行表达式）

${__eval({sql})}
例如：
name = Smith
column = age
table = birthdays
SQL = select columnfrom{table} where name = '${name}'

输出： select age from birthdays where name='Smith'

evalVar

用来执行保存在变量中的表达式，并返回执行结果，并把结果存入一个变量，供 Sampler 引用。

${__evalVar()}
输入：
输出：

FileToString

FileToString函数可用于读取整个文件。每次调用它时，它都会读取整个文件。
如果打开或读取文件时发生错误，则函数返回字符串"ERR"

${__FileToString(D:\JmeterData\he.txt,utf-8,)}
输入：D:\JmeterData\he.txt
输出：1,2,3

groovy

执行groovy脚本

${__groovy("myVar".substring(0\,2))}
输入："myVar".substring(0\,2)
输出：my

intSum

参数（整数）求和

${__intSum(1,2,)}
输入：1，2
输出：3

isPropDefined

如果property存在则返回true，否则返回false。

${__isPropDefined(usercount)}
输入：
输出：false

isVarDefined

如果var存在则返回true，否则返回false。

${__isVarDefined(1)}
输入：
输出：false

javaScript

javaScript函数执行一段javaScript(不是Java!)代码并返回它的值

${__javaScript(new Date(),)}
输入：new Date()
输出：[Date 2021-05-08T08:02:37.258Z]

jexl2

jexl函数返回对Commons jexl表达式求值的结果

${__jexl2(1+1==3,)}
输入：1+1==3
输出：false

jexl3

jexl函数返回对Commons jexl表达式求值的结果

${__jexl3(1+1==3,)}
输入：1+1==3
输出：false

log

log函数记录一条消息，并返回其输入字符串（打印日志）

${__log(111,out,,)}
输入：111
输出：111
参数讲解：
第 1 个参数：要记录（和返回）的字符串
第 2 个参数：日志级别有 OUT，ERR，DEBUG，INFO (default) ，WARN or ERROR
OUT:  在控制台打印出来 (点击快捷菜单栏的 △0（带感叹号“!”的三角形） 按钮，在 GUI 中打开控制台)，
另外也会打印到标准输出窗口(在 Windows 下我们运行 JMeter 时会有一个标准输出窗口)
第3/4个参数可选

logn

与 log 类似，不过它只记录一条日志，不返回值而已

${__logn(哈哈,err,)}
输入：
输出：

longSum

与 __intSum 类同，只不过把整数变成了长整型

${__longSum(1,2,)}
输入：1，2
输出：3

machineIP

获取设备IP

${__machineIP()}
输入：
输出：192.168.56.1

machineName

获取设备名称

${__machineName()}
输入：
输出：输出电脑名称

P

获取设备名称

${__P(,1)}
输入：
输出：

1、获取属性的函数，可以获取命令行中定义的属性，默认值为 1 。
// 例如：我们在命令窗口打开 JMeter 且设置 group1.threads = 7 ，我们在打开的 JMeter GUI 中可以获取到此参数。
// 在非 GUI 方式运行测试计划时这个函数可用来做参数化，由运行命令动态指定参数值，
// 方便我们与 Jenkins 、Maven 或者 Ant 进行集成未完成性能测试自动化工作。
2、函数 __P 是一个简化版的属性函数，目的是使用在命令行中定义的属性。
3、不同于函数 __property ，本函数没有提供选项用于设置保存属性值的变量。
4、另外，如果没有设置默认值，默认值自动设为 1 。

property

获取properties文件中的属性值

${__property(upgrade_properties,,)}
输入：pgrade_properties
输出：/bin/upgrade.properties

Random

生成控制范围之间的随机整数

${__Random(1,10,)}
输入：
输出：1-10随机整数

RandomDate

生成给定的开始日期和结束日期之间的随机日期（日期、不是时间）（可指定日期格式）

${__RandomDate(yyyy-MM-dd,2021-05-01,2021-05-20,,)}
输入：2021-05-01 , 2021-05-20
输出：2021-05-06

RandomFromMultipleVars

对给定的几个var1，var2，var3变量进行一个随机取值

${__RandomFromMultipleVars(var1,var2)}
输入：var1,var2
输出：var1或者var2

RandomString

随机生成字符，可指定字符的长度和可进行随机的字符串序列

${__RandomString(3,你好啊，我是小爱同学。,)}
输入：
输出：你好。

regexFunction

Regex函数用于使用任何正则表达式(由用户提供)解析前面的响应(或变量的值)。函数返回填充了变量值的模板字符串。
https://jmeter.apache.org/usermanual/functions.html#__regexFunction

${__regexFunction(,,,,,,)}
输入：
输出：

samplerName

获取当前Sampler的名称

${__samplerName(qq)}
输入：
输出：Sampler名称

setProperty

动态设置jmeter变量

${__setProperty(qq,11,false)}
输入：qq = 11
输出：

split

分割字符串（指定字符串，存储变量名称，分隔符）

${__split(1\,2\,3,a,\,)}
输入：1，2，3
输出：1，2，3
      a_1=1
      a_3=3
      a_2=2