refactor: rename clearOutputOnRun to clearDebugOutputOnRun, OutputChannel to PHPUnit Debug

The OutputChannel is used for debug/raw output. Rename the setting and
display name to reflect this purpose.

Author: recca0120

packages/extension/CHANGELOG.md

@@ -24,6 +24,8 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 - Refactor: replace base64 filter encoding with placeholder approach
 - Refactor: rename OutputChannelObserver to RawOutputObserver, organize Writers
 - Refactor: strip ANSI codes in RawOutputObserver and ErrorDialogObserver
+- Rename: OutputChannel display name from "PHPUnit" to "PHPUnit Debug"
+- Rename: `clearOutputOnRun` setting to `clearDebugOutputOnRun`
 
 ## [3.9.25] - 2026-02-24
 

packages/extension/README.md

@@ -74,8 +74,8 @@ Add to `.vscode/settings.json`. All settings use the `phpunit.*` prefix.
   // Override individual format fields from the preset (see phpunit package docs)
   "phpunit.output.format": {},
 
-  // Clear output channel before each run (default: true)
-  "phpunit.clearOutputOnRun": true,
+  // Clear debug output channel before each run (default: true)
+  "phpunit.clearDebugOutputOnRun": true,
 
   // When to show output: "always" | "onFailure" | "never" (default: "onFailure")
   "phpunit.showAfterExecution": "onFailure",

packages/extension/README.zh-TW.md

@@ -74,8 +74,8 @@
   // 覆寫預設的個別格式欄位（詳見 phpunit 套件文件）
   "phpunit.output.format": {},
 
-  // 每次執行前清除輸出頻道（預設：true）
-  "phpunit.clearOutputOnRun": true,
+  // 每次執行前清除除錯輸出頻道（預設：true）
+  "phpunit.clearDebugOutputOnRun": true,
 
   // 何時顯示輸出："always" | "onFailure" | "never"（預設："onFailure"）
   "phpunit.showAfterExecution": "onFailure",

packages/extension/package.json

@@ -150,10 +150,10 @@
                     "description": "Override individual format fields from the preset. See documentation for available fields.",
                     "scope": "resource"
                 },
-                "phpunit.clearOutputOnRun": {
+                "phpunit.clearDebugOutputOnRun": {
                     "type": "boolean",
                     "default": true,
-                    "description": "True will clear the output when we run a new test. False will leave the output after every test.",
+                    "description": "Clear the debug output channel before each test run.",
                     "scope": "resource"
                 },
                 "phpunit.showAfterExecution": {

packages/extension/src/Observers/RawOutputObserver.test.ts

@@ -15,7 +15,7 @@ describe('RawOutputObserver clear behavior', () => {
     const createObserver = (config: Record<string, unknown> = {}) => {
         const outputChannel = vscode.window.createOutputChannel('phpunit');
         const configuration = new Configuration({
-            clearOutputOnRun: true,
+            clearDebugOutputOnRun: true,
             ...config,
         });
         const observer = new RawOutputObserver(outputChannel, configuration);
@@ -44,7 +44,7 @@ describe('RawOutputObserver clear behavior', () => {
 
     it('each observer instance clears independently', () => {
         const outputChannel = vscode.window.createOutputChannel('phpunit');
-        const configuration = new Configuration({ clearOutputOnRun: true });
+        const configuration = new Configuration({ clearDebugOutputOnRun: true });
         const observer1 = new RawOutputObserver(outputChannel, configuration);
         const observer2 = new RawOutputObserver(outputChannel, configuration);
 
@@ -68,7 +68,7 @@ describe.each(detectPhpUnitStubs())('RawOutputObserver on $name (PHPUnit $phpUni
             php: 'php',
             phpunit: binary,
             args: ['-c', 'phpunit.xml', ...stubArgs],
-            clearOutputOnRun: true,
+            clearDebugOutputOnRun: true,
         });
         testRunner = new TestRunner();
         const outputChannel = vscode.window.createOutputChannel('phpunit');
@@ -98,7 +98,7 @@ describe.each(detectPhpUnitStubs())('RawOutputObserver on $name (PHPUnit $phpUni
     }
 
     it('should not clear output channel', async () => {
-        await configuration.update('clearOutputOnRun', false);
+        await configuration.update('clearDebugOutputOnRun', false);
         const testFile = phpUnitProject('tests/AssertionsTest.php');
         const filter = 'test_passed';
         await run(testFile, filter);

packages/extension/src/Observers/RawOutputObserver.ts

@@ -28,7 +28,7 @@ export class RawOutputObserver implements TestRunnerObserver {
             return;
         }
 
-        if (this.configuration.get('clearOutputOnRun') === true) {
+        if (this.configuration.get('clearDebugOutputOnRun') === true) {
             this.writer.clear();
         }
 

packages/extension/src/extension.test.ts

@@ -300,7 +300,7 @@ describe('Extension Test', () => {
             );
 
             expect(workspace.getConfiguration).toHaveBeenCalledWith('phpunit', expect.anything());
-            expect(window.createOutputChannel).toHaveBeenCalledWith('PHPUnit', 'phpunit');
+            expect(window.createOutputChannel).toHaveBeenCalledWith('PHPUnit Debug', 'phpunit');
             expect(tests.createTestController).toHaveBeenCalledWith('phpunit', 'PHPUnit');
             for (const cmd of [
                 'phpunit.reload',

packages/extension/src/extension.ts

@@ -33,7 +33,7 @@ export async function activate(context: ExtensionContext) {
     });
 
     const ctrl = tests.createTestController('phpunit', 'PHPUnit');
-    const outputChannel = window.createOutputChannel('PHPUnit', 'phpunit');
+    const outputChannel = window.createOutputChannel('PHPUnit Debug', 'phpunit');
     const parentContainer = createParentContainer(ctrl, outputChannel);
     const folderManager = parentContainer.get(WorkspaceFolderManager);