Method Run

src/testing/testing.go:500–529

Run runs f as a subtest of t called name. It waits until the subtest is finished and returns whether the subtest succeeded.

(name string, f func(t *T))

// Run runs f as a subtest of t called name. It waits until the subtest is finished
// and returns whether the subtest succeeded.
func (t *T) Run(name string, f func(t *T)) bool {
	t.hasSub = true
	testName, ok, _ := t.context.match.fullName(&t.common, name)
	if !ok {
		return true
	}

	// Create a subtest.
	ctx, cancelCtx := context.WithCancel(context.Background())
	sub := T{
		common: common{
			output:    &logger{logToStdout: flagVerbose},
			name:      testName,
			parent:    &t.common,
			level:     t.level + 1,
			ctx:       ctx,
			cancelCtx: cancelCtx,
		},
		context: t.context,
	}
	if t.level > 0 {
		sub.indent = sub.indent + "    "
	}
	if flagVerbose {
		fmt.Fprintf(t.output, "=== RUN   %s\n", sub.name)
	}

	tRunner(&sub, f)
	return !sub.failed
}

// Deadline reports the time at which the test binary will have
// exceeded the timeout specified by the -timeout flag.