fnm download snippet fails on Windows

[MikeMcC399]

URL:

https://nodejs.org/en/download

Browser Name:

Microsoft Edge

Browser Version:

133.0.3065.59 (Official build) (64-bit)

Operating System:

Windows 11 24H2 10.0.26100.3037

How to reproduce the issue:

Steps

Copy and run the download instructions from https://nodejs.org/en/download for Windows using fnm with npm in a PowerShell terminal:

# Download and install fnm:
winget install Schniz.fnm

# Download and install Node.js:
fnm install 22

# Verify the Node.js version:
node -v # Should print "v22.13.1".

# Verify npm version:
npm -v # Should print "10.9.2".

Expectation

The snippet should run without error.

The implicit assumption of offering a "Copy to clipboard" button with a label "PowerShell" is that the shell script can be copied and run as-is.

In fact, a user needs to visit https://github.com/Schniz/fnm/blob/master/README.md and navigate a complex set of instructions to set up fnm to work on Windows.

Actual

Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.

Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows

PS C:\Users\mikem> # Download and install fnm:
PS C:\Users\mikem> winget install Schniz.fnm
Found Fast Node Manager [Schniz.fnm] Version 1.38.1
This application is licensed to you by its owner.
Microsoft is not responsible for, nor does it grant any licenses to, third-party packages.
Successfully verified installer hash
Extracting archive...
Successfully extracted archive
Starting package install...
Command line alias added: "fnm"
Successfully installed
PS C:\Users\mikem>
PS C:\Users\mikem> # Download and install Node.js:
PS C:\Users\mikem> fnm install 22
Installing Node v22.13.1 (x64)
PS C:\Users\mikem>
PS C:\Users\mikem> # Verify the Node.js version:
PS C:\Users\mikem> node -v # Should print "v22.13.1".
node : The term 'node' is not recognized as the name of a cmdlet, function, script file, or operable program. Check
the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ node -v # Should print "v22.13.1".
+ ~~~~
    + CategoryInfo          : ObjectNotFound: (node:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

PS C:\Users\mikem>
PS C:\Users\mikem> # Verify npm version:
PS C:\Users\mikem> npm -v # Should print "10.9.2".
npm : The term 'npm' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the
spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ npm -v # Should print "10.9.2".
+ ~~~
    + CategoryInfo          : ObjectNotFound: (npm:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

Related

• Similar to nvm download snippet fails on first run #7433

[avivkeller]

IIUC we need to add the following line:

'fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression' >> $PROFILE

Does executing that fix the issue?

[avivkeller]

No response from OP, I'm going to verify this solution today, and if it does work, I'll send a PR accordingly

[MikeMcC399]

@avivkeller

Sorry. I somehow missed your post. I will see if I can test your solution.

[MikeMcC399]

@avivkeller

Unfortunately just adding

'fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression' >> $PROFILE

to the script does not solve all the issues. It seems that there are multiple barriers to providing a script which runs error free in one single invocation on a freshly installed Windows system and sets up fnm and Node.js.

I don't know if there is any simple solution to this.

1. After installing Schniz.fnm it says:

   Command line alias added: "fnm"
   Path environment variable modified; restart your shell to use the new value.

2. Attempting to execute 'fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression' >> $PROFILE if there is no PowerShell profile available results in the error "Could not find a part of the path" ... "DirectoryNotFoundException"

3. Simply creating a profile according to https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-7.5#how-to-create-a-profile as follows, allows the fnm command to be added to the profile, however when PowerShell tries to use this it reports "WindowsPowerShell\Microsoft.PowerShell_profile.ps1 is not digitally signed" ... "PSSecurityException"

   if (!(Test-Path -Path $PROFILE)) {
   New-Item -ItemType File -Path $PROFILE -Force
   }

4. If node -v is executed without restarting the terminal then the error node : The term 'node' is not recognized as the name ... is displayed. This issue goes away if the PowerShell terminal is restarted.

Edit: The above refers to testing on Windows 11 24H2.

[avivkeller]

wow! There are several levels to this issue. @Schniz do you happen to have a simple script, assuming the user is installing on a PS7+ shell?

[avivkeller]

The way I see it,

On the + side:

• It's supported on all distributions
• 3.2m+ users
• Actively maintained and regularly updated

On the - side (for Windows only):

• Different instructions depending on the terminal in use, and the version of said terminal
• Troubleshooting requires familiarity with Windows-specific quirks
• Not beginner-friendly compared to other methods

(Bullets 1 and 2 refer to https://github.com/Schniz/fnm/tree/master?tab=readme-ov-file#powershell)

[MikeMcC399]

Microsoft recommends other Node.js version managers:

See https://learn.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows

[ovflowd]

Microsoft recommends other Node.js version managers:

See https://learn.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows

FYI nvm-windows is on maintenance mode and being superseded by https://github.com/coreybutler/nvm-windows/wiki/Runtime

[MikeMcC399]

@avivkeller / @ovflowd

If there is any discussion about replacing fnm as a Windows recommendation, that should probably be done under a different issue. (FWIW: I actually use an older version of nvm-windows@1.1.11 for my own daily work.)

This issue should really be focused on getting a working set of instructions to use fnm for Windows.

If there is no automated way to do this for Windows, then perhaps just some extra text would need to be added to the instructions.

Something like:

"# Visit https://github.com/Schniz/fnm for additional setup instructions"

# Download and install fnm:
winget install Schniz.fnm

# Visit https://github.com/Schniz/fnm for additional setup instructions

# Download and install Node.js:
fnm install 22

# Verify the Node.js version:
node -v # Should print "v22.13.1".

# Verify npm version:
npm -v # Should print "10.9.2".