Surface errors when writing to file

Scripts/FileIO/Save-ToFile.ps1

@@ -27,10 +27,11 @@ function Save-ToFile {
     )
 
     try {
-        $Config | ConvertTo-Json -Depth $MaxDepth | Set-Content -Path $FilePath -Encoding UTF8
+        $Config | ConvertTo-Json -Depth $MaxDepth | Set-Content -Path $FilePath -Encoding UTF8 -ErrorAction Stop
         return $true
     }
     catch {
+        Write-Error "Failed to write '$FilePath': $($_.Exception.Message)"
         return $false
     }
 }

Tests/Settings-And-Apps-FileIO.Tests.ps1

@@ -14,6 +14,19 @@ BeforeAll {
     $script:JsonFixturePath = Join-Path $PSScriptRoot 'TestData\JsonFileLoading'
 }
 
+Describe 'Save-ToFile' {
+    It 'reports the write error and returns false when persistence fails' {
+        Mock Set-Content { throw [System.IO.IOException]::new('Disk is full') }
+        Mock Write-Error {}
+
+        Save-ToFile -Config @{ Setting = $true } -FilePath (Join-Path $TestDrive 'settings.json') | Should -BeFalse
+
+        Should -Invoke Write-Error -Times 1 -Exactly -ParameterFilter {
+            $Message -eq "Failed to write '$TestDrive\settings.json': Disk is full"
+        }
+    }
+}
+
 Describe 'Import-Settings' {
     BeforeEach {
         $script:Params = @{}