feat: test.each support string template

packages/vitest/src/runtime/suite.ts

@@ -212,9 +212,21 @@ function createTest(fn: (
 )) {
   const testFn = fn as any
 
-  testFn.each = function<T>(this: { withContext: () => TestAPI }, cases: ReadonlyArray<T>) {
+  testFn.each = function<T>(this: { withContext: () => TestAPI }, cases: ReadonlyArray<T>, ...args: any[]) {
     const test = this.withContext()
 
+    // for template string
+    if (Array.isArray(cases) && args.length) {
+      const header = cases.join('').trim().replace(/ /g, '').split('\n').map(i => i.split('|'))[0]
+      cases = []
+      for (let i = 0; i < Math.floor((args.length) / header.length); i++) {
+        const oneCase: Record<string, any> = {}
+        for (let j = 0; j < header.length; j++)
+          oneCase[header[j]] = args[i * header.length + j] as any
+        ;(cases as any).push(oneCase)
+      }
+    }
+
     return (name: string, fn: (...args: T[]) => void, options?: number | TestOptions) => {
       const arrayOnlyCases = cases.every(Array.isArray)
       cases.forEach((i, idx) => {

packages/vitest/src/types/tasks.ts

@@ -130,6 +130,11 @@ interface TestEachFunction {
     fn: (...args: T[]) => Awaitable<void>,
     options?: number | TestOptions,
   ) => void
+  (...args: [TemplateStringsArray, ...any]): (
+    name: string,
+    fn: (...args: any[]) => Awaitable<void>,
+    options?: number | TestOptions,
+  ) => void
 }
 
 type ChainableTestAPI<ExtraContext = {}> = ChainableFunction<

test/core/test/each.test.ts

@@ -169,3 +169,29 @@ test.each([
   expect(value1).toBeNull()
   expect(value2).toBeNull()
 })
+
+test.each`
+a    | b    | expected
+${1} | ${1} | ${2}
+${'a'} | ${'b'} | ${'ab'}
+${[]} | ${'b'} | ${'b'}
+${{}} | ${'b'} | ${'[object Object]b'}
+${{ asd: 1 }} | ${'b'} | ${'[object Object]b'}
+`('returns $expected when $a is added $b', ({ a, b, expected }) => {
+  expect(a + b).toBe(expected)
+})
+
+test.each`
+a    | b    | expected
+${true} | ${true} | ${true}
+`('($a && $b) -> $expected', ({ a, b, expected }) => {
+  expect(a && b).toBe(expected)
+})
+
+test.each`
+a    | b    | expected
+${{ val: 1 }} | ${{ val: 2 }}} | ${3}
+`('($a && $b) -> $expected', ({ a, b, expected }) => {
+  expect(a.val + b.val).toBe(expected)
+})
+