node-tools

node-tools copied to clipboard

Node.js Tools for Visual Studio is extension for Visual Studio which provides support for editing and debugging node.js applications.

Thanks for all your contributions. It's time to move to Node.js Tools for Visual Studio.

Table Of Contents

• Features
• Installation
• Configuration
• Contribution
• License

Features

Node.js Projects

Node Tools package extends Visual Studio project system by njsproj type. Project templates can be found in the New Project dialog under JavaScript -> Web subcategory.

Debugger

Node Tools brings full debugging capability for a node.js applications. You navigate thought stacktraces (backtraces), change variable values, set conditional breakpoints and breaks on JavaScript exceptions.

Node Package Manager Console

Since npm is a standard de-facto for node.js modules Node Tools provides special console window for a package management purposes. So you can easily type usual commands inside of Visual Studio.

Nuget Package Manager

Also do not forget about regular nuget packages which can allow your scripts be up to date. Just use Nuget Package Manager dialog or console window.

Installation

Installation process is really straightforward:

• Install package inside Visual Studio by typing "Node Tools" in the Extensions and Updates dialog or download it from Visual Studio Gallery page
• Download & install node.js installer from the download page
• Download & extract archive with a node.js source code from the download page

Configuration

Node Tools Settings

Node Tools can automatically determine node.exe interpreter location, but if you want to launch concrete node.js interpreter version you can do that by click on Tools -> Options menu in the Node.js Tools dialog. Here you can change following settings:

• Node.js location
• Node.js startup parameters

Node.js Source Code Debugging

Currently to provide Visual Studio ability to navigate throught stacktraces during debugging session you should:

• Open properties dialog from the solution context menu
• Select Debug Source Files under Common Properties category
• Add to list src and lib folders from the extracted node.js source code archive (see installation section)

Node.js Debugger Settings

By default node.js lunched to accept debigging sessions on the port 5858. You can customize that at the project settings. Here you can change following settings:

• Debug port
• Startup file

Node.js Intellisense Setup (VS 2012)

1. Download the nodejs reference library zip file here
2. Add a folder to your project called ~/scripts
3. Extract the contents of the zip to your ~/scripts folder
4. Navigate to the [Tools] > [Options] > Text Editor > JavaScript > IntelliSense > References options
5. Select "Implicit (Web)" from the Reference Group dropdown at the top
6. And at the bottom in the "Add a reference to the current Group" text box put ~/Scripts/node.js and click add.

You should now have intellisense in your node scripts.

Contribution

Your feedback is very welcome. Please feel free to create issues and write you comments.

If you want to provide code contribution please fork this repository and create a pull request.

Launching Project

• Clone this repository and open NodeTools.sln
• Set NodeTools project as startup and open project properties
• In the Debug screen check Start external program and choose devenv.exe path
• Also in the Command line arguments set /RootSuffix Exp

License

Project source code is licensed under Apache 2.0. It contains portions of code from Microsoft Corporation and Outercurve Foundation.