{"record":{"id":"4047ba0505ee941c","repo":"grafana/k6","slug":"k6-experimental-grpc-has-been-graduated-please-us","errorCode":null,"errorMessage":"k6/experimental/grpc has been graduated, please use k6/net/grpc instead. See https://grafana.com/docs/k6/latest/javascript-api/k6-net-grpc/ for more information.","messagePattern":"k6/experimental/grpc has been graduated, please use k6/net/grpc instead\\. See https://grafana\\.com/docs/k6/latest/javascript-api/k6-net-grpc/ for more information\\.","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/js/jsmodules.go","lineNumber":107,"sourceCode":"\n\t// external is always prefixed with `k6/x`\n\tfor _, e := range external {\n\t\tresult[e.Name] = e.Module\n\t}\n\n\treturn result\n}\n\ntype removedModule struct {\n\terrMsg string\n}\n\nfunc newRemovedModule(errMsg string) modules.Module {\n\treturn &removedModule{errMsg: errMsg}\n}\n\nfunc (rm *removedModule) NewModuleInstance(vu modules.VU) modules.Instance {\n\tcommon.Throw(vu.Runtime(), errors.New(rm.errMsg))\n\n\treturn nil\n}\n\ntype warnExperimentalModule struct {\n\tonce sync.Once\n\tmsg  string\n\tbase modules.Module\n}\n\nfunc newWarnExperimentalModule(base modules.Module, msg string) modules.Module {\n\treturn &warnExperimentalModule{\n\t\tmsg:  msg,\n\t\tbase: base,\n\t}\n}\n\nfunc (w *warnExperimentalModule) NewModuleInstance(vu modules.VU) modules.Instance {","sourceCodeStart":89,"sourceCodeEnd":125,"githubUrl":"https://github.com/grafana/k6/blob/93accf6570dcd306ca5e99cc44c393ee3797761b/internal/js/jsmodules.go#L89-L125","documentation":"k6/experimental/grpc graduated to the stable k6/net/grpc module; the experimental import path was removed from the registry and now resolves to the removedModule stub, which throws at import-instantiation time.","triggerScenarios":"`import grpc from 'k6/experimental/grpc'` on a current k6 build.","commonSituations":"gRPC scripts from the experimental era run after upgrading k6; shared company libraries still importing the old specifier.","solutions":["Change the import to 'k6/net/grpc': `import grpc from 'k6/net/grpc'`","The Client API (grpc.newClient etc.) is unchanged; only the specifier needs updating in most scripts"],"exampleFix":"// before\nimport grpc from 'k6/experimental/grpc';\n\n// after\nimport grpc from 'k6/net/grpc';","handlingStrategy":"validation","validationCode":"grep -rn \"k6/experimental/grpc\" . --include='*.js' && { echo 'migrate to k6/net/grpc' >&2; exit 1; } || true","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use 'k6/net/grpc' in all new gRPC scripts","Codemod old imports during the k6 upgrade PR, not later","Keep gRPC proto loading via opener/importer unchanged — only the specifier moved"],"tags":["javascript","modules","grpc","migration","removed-feature"],"backgroundTag":null,"analyzedSha":"93accf6570dcd306ca5e99cc44c393ee3797761b","analyzedAt":"2026-08-15T21:23:27.118Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}