Add test for custom ToString implementations

This now works fine since the expansion takes place on the pipeline
thread.

Author: JustinGrote

test/PowerShellEditorServices.Test.Shared/Debugging/VariableTest.ps1

@@ -51,3 +51,19 @@ $sortedDictionary['blue'] = 'red'
 
 # This is a dummy function that the test will use to stop and evaluate the debug environment
 function __BreakDebuggerDerivedDictionaryPropertyInRawView{}; __BreakDebuggerDerivedDictionaryPropertyInRawView
+
+class CustomToString {
+    [String]$String = 'Hello'
+    [String]ToString() {
+        return $this.String.ToUpper()
+    }
+}
+$SCRIPT:CustomToStrings = 1..1000 | ForEach-Object {
+    [CustomToString]::new()
+}
+$SCRIPT:Small = $SCRIPT:CustomToStrings[1..10]
+$SCRIPT:Medium = $SCRIPT:CustomToStrings[1..50]
+$SCRIPT:Large = $SCRIPT:CustomToStrings[1..100]
+
+# This is a dummy function that the test will use to stop and evaluate the debug environment
+function __BreakDebuggerToStringShouldMarshallToPipeline{}; __BreakDebuggerToStringShouldMarshallToPipeline

test/PowerShellEditorServices.Test/Debugging/DebugServiceTests.cs

@@ -1144,5 +1144,21 @@ await debugService.SetCommandBreakpointsAsync(
             Assert.Contains(childVars, i => i.Name is "Exists" && i.ValueString is "$true");
             Assert.Contains(childVars, i => i.Name is "LastAccessTime");
         }
+
+
+        // Verifies Issue #1686
+        [Fact]
+        public async Task DebuggerToStringShouldMarshallToPipeline()
+        {
+            CommandBreakpointDetails breakpoint = CommandBreakpointDetails.Create("__BreakDebuggerToStringShouldMarshallToPipeline");
+            await debugService.SetCommandBreakpointsAsync(new[] { breakpoint }).ConfigureAwait(true);
+
+            // Execute the script and wait for the breakpoint to be hit
+            Task _ = ExecuteVariableScriptFileAsync();
+            AssertDebuggerStopped(commandBreakpointDetails: breakpoint);
+
+            VariableDetailsBase[] childVars = await GetVariables(VariableContainerDetails.ScriptScopeName).ConfigureAwait(true);
+            Assert.Contains(childVars, i => i.Name is "$CustomToStrings");
+        }
     }
 }