René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Import-Module does not properly report errors to users","articleBody":"If you have a script module that generates a terminating error, the error message shown to users does not indicate that the error came from `Import-Module`. Instead it simply shows the script module internals. This is inappropriate for users who may not have authored that script module.\r\n\r\nIf you have a function in a script module that generates a terminating error, and you invoke that function when the module is not loaded, the module will load, the terminating error will not be shown to end users at all, and the function will run. The suppression of the terminating error in this scenario needs to be corrected so that users see the error came from Import-Module which was implicitly invoked by invoking the command while auto-loading is enabled.\r\n\r\n**Note:** This issue is closely related to the problem with terminating error handling in PowerShell (for which [a collection of RFCs have been submitted as a PR](https://github.com/PowerShell/PowerShell-RFC/pull/187)). Terminating error handling aside, this issue focuses on how Import-Module does a poor job of reporting errors, sometimes not even reporting them at all.\r\n\r\n# Steps to reproduce\r\n\r\n```powershell\r\n$moduleName = 'ModuleErrorHandlingTest'\r\n$modulePath = Join-Path -Path $([Environment]::GetFolderPath('MyDocuments')) -ChildPath PowerShell/Modules/${moduleName}\r\nNew-Item -Path $modulePath -ItemType Directory -Force \u003e $null\r\n$nmmParameters = @{\r\n    Path = \"${modulePath}/${moduleName}.psd1\"\r\n    RootModule = \"./${moduleName}.psm1\"\r\n    FunctionsToExport = @('Test-ErrorHandling')\r\n}\r\nNew-ModuleManifest @nmmParameters\r\n$scriptModulePath = Join-Path -Path $modulePath -ChildPath \"${moduleName}.psm1\"\r\nNew-Item -Path $scriptModulePath -ItemType File | Set-Content -Encoding UTF8 -Value @'\r\n    1/0 # Oops!\r\n    function Test-ErrorHandling {\r\n        [cmdletBinding()]\r\n        param()\r\n        'Error handling output'\r\n    }\r\n'@\r\n\r\n# This next command generates an error while loading the module, but the module still\r\n# loads, and the error message does not tell the user that it came from Import-Module\r\n# nor does it tell the user which module was being loaded when the error occurred.\r\nImport-Module $moduleName\r\nRemove-Module $moduleName\r\n\r\n# This next command generates an error while implicitly loading a module, but the error\r\n# is silenced and the module loads anyway so the end user has no idea that something\r\n# happened.\r\nTest-ErrorHandling\r\nRemove-Module $moduleName\r\nRemove-Item -LiteralPath $modulePath -Recurse -Force\r\n```\r\n\r\n# Expected behavior\r\n\r\nNote the differences in the actual error text that are shown in what should be expected when a module is loaded over what is actually shown below this code block.\r\n\r\n```none\r\nImport-Module: Unexpected error while importing ModuleErrorHandlingTest module. Attempted to divide by zero.\r\nAt line:23 char:1\r\n+ Import-Module $moduleName\r\n+ ~~~~~~~~~~~~~~~~~~~~~~~~~\r\n+ CategoryInfo          : NotSpecified: (:) [], RuntimeException\r\n+ FullyQualifiedErrorId : RuntimeException\r\n\r\nImport-Module: Unexpected error while implicitly importing ModuleErrorHandlingTest module. Attempted to divide by zero.\r\nAt line:29 char:1\r\n+ Test-ErrorHandling\r\n+ ~~~~~~~~~~~~~~~~~~\r\n+ CategoryInfo          : NotSpecified: (:) [], RuntimeException\r\n+ FullyQualifiedErrorId : RuntimeException\r\n\r\nError handling output\r\n```\r\n\r\n# Actual behavior\r\n\r\n```none\r\nAttempted to divide by zero.\r\nAt C:\\Users\\kirka\\OneDrive\\Documents\\PowerShell\\Modules\\ModuleErrorHandlingTest\\ModuleErrorHandlingTest.psm1:1 char:5\r\n+     1/0 # Oops!\r\n+     ~~~\r\n+ CategoryInfo          : NotSpecified: (:) [], RuntimeException\r\n+ FullyQualifiedErrorId : RuntimeException\r\n\r\nError handling output\r\n```\r\n\r\n# Environment data\r\n\r\n\u003c!-- provide the output of $PSVersionTable --\u003e\r\n\r\n```none\r\nName                           Value\r\n----                           -----\r\nPSVersion                      6.2.0\r\nPSEdition                      Core\r\nGitCommitId                    6.2.0\r\nOS                             Microsoft Windows 10.0.17763\r\nPlatform                       Win32NT\r\nPSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}\r\nPSRemotingProtocolVersion      2.3\r\nSerializationVersion           1.1.0.1\r\nWSManStackVersion              3.0\r\n```\r\n","author":{"url":"https://github.com/KirkMunro","@type":"Person","name":"KirkMunro"},"datePublished":"2019-06-07T19:50:38.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":12},"url":"https://github.com/9855/PowerShell/issues/9855"}