My First Visual Code Extension

Screenshot of the extension in use

I am really a big fan of Visual Code and use it as my main IDE for software development. The available selection of extensions (see the Extension Marketplace) is amazing.

As I started using Visual Code I found every extension I was looking for. But lastly I stumbled upon a feature where I could not find an extension for. So I decided to write my first VS code extension and let you know about my experiences during the development.

The problem I wanted to solve

Currently I am doing a lot of Angular development and therefore use Jasmine for unit tests. My first IDE which I used for web development was WebStorm which is based on IntelliJ IDEA. In WebStorm I often used and liked the plugin ddescriber for Jasmine tests:

Intellij plugin to quickly transform a JavaScript test block from describe() to ddescribe() and a test it() into iit()

This is a nice feature but I often used the plugin to list all available specs and then jump to certain describe() or it() block:

Just type Ctrl + Shift + D (Command + Shift + D on a Mac) to launch a dialog that lets you choose which suites or unit tests you want to include or exclude.

This is useful in large unit tests which includes many describe() or it() blocks.

As I could not find a VS code extension which solves this problem, I decided to write my first own VS code extension.

What the extension should handle

The first version of the extension should be able to:

List all describe() or it() blocks as dropdown in an opened file in the editor
If a block is selected, move the cursor to this block

How to start?

Big applause to the VS code team for the amazing documentation on how to build your own VS code extension.

It is really easy to grab one of the example projects or create a new one using Extension Generator and get started. Additionally it is very easy to run and debug your new extension.

Searching through the Extension API documentation I found this method

showQuickPick(items: T[] | Thenable<T[]>, options?: QuickPickOptions, token?: CancellationToken): Thenable<T | undefined>

which functionality is described as:

Shows a selection list allowing multiple selections.

It looks this way in VS code if it is called:

So this sounded like a good opportunity to list all test blocks and provide a way to receive the selected value.

So basically I had to implement these steps:

Grab all strings in the opened editor which include it( or describe( and the corresponding line number of this string
Pass them to showQuickPick method
Receive the selection and move the cursor the corresponding line number

The final output for a Jasmine test file looks like this:

Publishing the extension

Another very nice experience was the very easy publishing process for VS code extensions. Basically I had just to follow the official documentation which requires an Visual Studio Team Services account.

The published extension is available in the Visual Studio Code Marketplace.

Conclusion

In summary it made a lot of fun to develop a VS code experience. The documentation and the provided examples are very good and I am very happy to have added a functionality to my favorite code editor which I have been missing.

Links

Originally published at www.mokkapps.de.

My First Visual Code Extension

Comments

More from this blog

Create a Table of Contents With Active States in Nuxt 3

Building a Polite Newsletter Popup With Nuxt 3

Create an RSS Feed With Nuxt 3 and Nuxt Content v2

How to Create a Custom Code Block With Nuxt Content v2

How to Create a Custom Code Block With Nuxt Content v2

The problem I wanted to solve

What the extension should handle

How to start?

Publishing the extension

Conclusion

Links

Command Palette

Comments

More from this blog

The problem I wanted to solve

What the extension should handle

How to start?

Publishing the extension

Conclusion

Links