Downloads: Windows: User System Arm64 | Mac: Universal Intel silicon | Linux: deb rpm tarball Arm snap
Welcome to the May 2023 release of Visual Studio Code. There are many updates in this version that we hope you’ll like, some of the key highlights include:
If you’d like to read these release notes online, go to Updates on code.visualstudio.com.
Insiders: Want to try new features as soon as possible? You can download the nightly Insiders build and try the latest updates as soon as they are available.
Accessibility
Contents
- 1 Accessibility
- 2 Workbench
- 3 Editor
- 4 Terminal
- 5 Source Control
- 6 Notebooks
- 7 Languages
- 7.1 TypeScript 5.1
- 7.2 Linked editing for JSX tags
- 7.3 Rename matching JSX tags using F2
- 7.4 JSDoc @param completions
- 7.5 Copy external media files into workspace on drop or paste for Markdown
- 7.6 IntelliSense for HTML paths in Markdown files
- 7.7 Insert audio into Markdown
- 7.8 Syntax highlighting for JSON with Lines (JSONL) files
- 8 Remote Development
- 9 Contributions to extensions
- 9.1 GitHub Copilot
- 9.1.1 Use Copilot Chat in Stable VS Code
- 9.1.2 Editor chat
- 9.1.3 Notebook improvements
- 9.1.4 GitHub Pull Request and Issues integration
- 9.1.5 Experimental Quick Question experience
- 9.1.6 Delete chat entry
- 9.1.7 Chat session history
- 9.1.8 Export chat sessions to JSON file
- 9.1.9 Codeblock navigation and keybindings
- 9.1.10 Copilot YouTube playlist
- 9.2 Python
- 9.3 Jupyter
- 9.4 GitHub Pull Requests and Issues
- 9.1 GitHub Copilot
- 10 Preview features
- 11 WebAssemblies in VS Code for the Web
- 12 Extension authoring
- 13 Proposed APIs
- 14 Engineering
- 15 VS Code at Microsoft Build
- 16 Notable fixes
- 17 Thank you
Verbosity settings
Additional accessibility.verbosity settings have been added to inform screen reader users how to interact with features when they are focused.
For GitHub Copilot, there are hints describing how to access the accessible help menus for the Copilot chat view and in editor code chat via:
accessibility.verbosity.chat
accessibility.verbosity.interactiveEditor
These help menus provide information about what to expect, how to navigate from the input box to other elements, and more.
Other new verbosity
settings provide information for specific VS Code UI:
accessibility.verbosity.keybindingsEditor
– when in the Keyboard Shortcuts editor.accessibility.verbosity.notebook
– when in a notebook.
The accessibility.verbosity
settings are enabled by default (set to ‘true’) but you can silence them individually.
Settings editor
VoiceOver on macOS now reads the descriptions of enum setting options in the Settings editor. Try it out with enum settings such as files.autoSave
and editor.accessibilitySupport
.
Workbench
Readonly mode
In some development scenarios, it can be helpful to explicitly mark some of a workspace’s folders or files as read-only. For example, if the folder or file contents is being managed by a different process (such as the node_modules
folder that is managed by Node.js package manager), marking them are read-only can avoid inadvertent changes.
For this use case, there are new settings to mark file paths as read-only in the Explorer and in text and notebook editors:
files.readonlyInclude
– Paths or glob patterns to make a file read-only if matching.files.readonlyExclude
– Paths or glob patterns to skip files from being read-only when they matchfiles.readonlyInclude
.files.readonlyFromPermissions
– Whether a file that has no write-permissions on disk should be read-only.
According to the rules of the settings, if a path is considered to be read-only, you cannot modify it from the Explorer (for example, delete it) and the text or notebook editor is read-only.
For more ad-hoc toggling of the read-only mode, there are new commands to change the mode for the current session only, overruling your setting configurations:
- Set Active Editor Readonly in Session – Mark active editor read-only.
- Set Active Editor Writeable in Session – Mark active editor writeable.
- Toggle Active Editor Readonly in Session – Toggle between read-only and writeable.
- Reset Active Editor Readonly in Session – Reset the session state.
Windows UNC host allowlist improvements
As part of an important security fix, VS Code introduced an allowlist for UNC hosts. This milestone we addressed many of the usability problems reported by Windows users when they have UNC paths in their day to day work with VS Code.
Dialog improvements
The confirmation dialog to allow a UNC host on startup now updates the security.allowedUNCHosts
setting and adds the host when you select the checkbox.
In addition, clicking the Learn More button no longer closes the dialog.
New security.restrictUNCAccess setting
A new setting security.restrictUNCAccess
lets you disable the UNC allowlist for hosts and restore the behavior to how it was before this security fix. We strongly advise against changing this setting, as it makes your system vulnerable again to the Information Disclosure Vulnerability.
New tab sizing option fixed
The workbench.editor.tabSizing
setting has a new option fixed
that makes each tab equal width. When space becomes limited, tabs will shrink equally up to a minimum. The new setting workbench.editor.tabSizingFixedMaxWidth
sets the initial size of the tab.
In this mode, when you rapidly close tabs using the mouse, the widths of tabs remain stable to allow for closing each tab by clicking onto the same point. The width is then adjusted when you leave the mouse from the editor tab area.
Network quality indication
When you are connected to a remote machine, the best experience for VS Code remote editing capabilities requires a good network connection with low latency. In this milestone, we updated the remote indicator in the Status bar to give you some feedback when either latency is very high or the network connection appears to be offline.
High latency (web, desktop)
We periodically measure the latency to the remote you are connected to. When a certain threshold is hit, the remote indicator updates to reflect that.
Offline detection (web only)
If you are using a web browser to connect to a remote and you suddenly lose internet connection, the remote indicator updates to reflect that.
Continue Working On
The Continue Working On feature allows you to store and retrieve working changes between VS Code development environments for the same repository, for example, when you upgrade from a local Git repository to a GitHub codespace, or when you switch between different machines for the same repository.
You can now transfer working changes between development environments for a GitHub repository even if it is configured with an HTTP remote in one environment and an SSH remote in another. Additionally, we have started to transfer additional workbench state, such as your Source Control view state preference, for a more seamless transition.
Editor
Paste as
When pasting a file into a text editor, there are multiple ways you might want to insert it. You may want an absolute path point to the file. You may want a path relative to the current workspace. Or you may even want something specific to the current editor’s language, such as inserting a Markdown link to the file when pasting into Markdown. VS Code’s new ‘paste as’ functionality gives you control over how the pasted content is inserted.
After pasting, VS Code now shows a small ‘paste as’ control if there are other ways the pasted content could have been inserted:
You can open the ‘paste as’ control by clicking on it or using the ⌘. (Windows, Linux Ctrl+.) keyboard shortcut. The paste selector goes away as soon as you start typing or move the cursor outside of the inserted text. You can also fully disable the drop selector control using "editor.pasteAs.showPasteSelector": "never"
.
When you paste content into a Markdown cell in a notebook, for example, the ‘paste as’ control lets you switch between:
- Inserting the image as an attachment
- Inserting a Markdown image reference
- Inserting a relative path (for files in the workspace)
- Inserting an absolute path
If you prefer selecting how content in the clipboard should be pasted before actually pasting, you can instead use the new Paste As… command. This lets you select how the content should be pasted:
Quick suggestions and snippets
Quick suggestions mean that VS Code shows suggestions as you type, without having to press ⌃Space (Windows, Linux Ctrl+Space). This feature is widely popular, around 90% of all suggestion sessions are started by typing. A large number of suggestions are accepted via Tab
(versus Enter
and typing accept characters).
When a snippet is being inserted, the Tab
key is used to navigate between snippet placeholders. Now, when quick suggestion becomes active while a snippet is being inserted, the Tab
key can accept a completion or navigate to the next snippet placeholder. To resolve this conflict, there is the editor.suggest.snippetsPreventQuickSuggestions
setting to disable quick suggestions when a snippet is inserted. It defaulted to true
and as long as this setting existed, we received feedback that it was confusing. So we have decided to change its default value to false
, so that typing inside a snippet placeholder will trigger quick suggestions.
You can then use the following keystrokes:
- Press
Tab
to accept a completion. - Press
Escape
to hide quick suggestions. - And
Tab
without suggestions navigates to the next snippet placeholder.
Terminal
Automatic shell integration for fish shell
Shell integration and its enhanced user experience will now automatically activate for fish shell. You may need to update fish for this to work.
Overline support
The overline escape sequences (SGR 53
, SGR 55
) specified in ECMA-48 are now supported in the terminal. The most common use of this sequence is to add a line above an app’s “status bar” on the bottom row of the terminal.
Source Control
Default branch name
Starting with this milestone, all new Git repositories created using VS Code set main
as their default branch. If you prefer a different name for the default branch, you can change it with the git.defaultBranchName
setting. When the setting is set to empty, VS Code defers to the default branch name configured in Git. Publishing a folder to GitHub also honors the default branch name configured on GitHub.
Branch picker integration with vscode.dev and GitHub
You can now checkout a branch in vscode.dev or open it on GitHub.com from the branch picker on VS Code desktop.
In the short video below, each branch listed in the branch picker dropdown has buttons on the right to either Open on GitHub or Checkout on vscode.dev.
Similarity threshold
Git status uses a similarity index (number of additions/deletions compared to the file’s size) to determine whether an add/delete pair is considered a rename. You can now configure the similarity threshold with the git.similarityThreshold
setting, which takes a value between 0
and 100
. The default value is 50
.
Notebooks
Rich content search
You can now search for rich content in open notebooks from the Search control. If your notebook is open, the Search control shows results based on how it appears in the notebook editor (rather than searching the content of the raw source file). This also allows for replacing text in the notebook inputs.
Using the new notebook search toggle, you can also filter which types of cell content you would like to search in.
Improved cell output interaction
The new context key notebookOutputInputFocused
was added to determine if a text box within a cell output has focus, so that raw hotkeys a/b/j/k can safely be used while the output has focus. Focusing on an input box prevents those hotkeys from triggering.
Format on Run
Notebooks now can format cells upon cell execution. This will trigger using Run Cell, Run All, Run Above/Below, and combined kernel+run commands. This feature can be turned on via setting "notebook.formatOnCellExecution": true
.
Code Actions on save
Notebooks now support Code Actions being run upon save. Code Actions can be specified under the notebook.codeActionsOnSave
setting. Extension authors can define providers using the standard typings for cell level Code Actions, or use the new notebook.
prefix to define Code Actions that manage the entire notebook. You can review the clean-nb-imports-ext sample extension to learn how extensions can use this new setting.
Languages
TypeScript 5.1
VS Code now ships with TypeScript 5.1.3. This major update brings new TypeScript language features, better performance, and many important improvements and bug fixes. You can read about TypeScript 5.1 on the TypeScript blog.
With linked editing, when you change an opening JSX tag VS Code will automatically update the corresponding closing tag. This can be a great time saver:
The feature is off by default but can be enabled by setting:
"editor.linkedEditing": true
You can also explicitly start linked editing with the Start Linked Editing command.
When you trigger rename on a JSX tag, VS Code now renames just the matching tag instead of trying to update all references to the tag:
This requires TypeScript 5.1+ and matches how rename works in HTML.
You can disable this behavior using javascript.preferences.renameMatchingJsxTags
and typescript.preferences.renameMatchingJsxTags
.
JSDoc @param completions
When writing JSDoc comments, VS Code now shows suggestions for all missing parameters:
This can help you quickly fill in the documentation.
In JavaScript files, @param
completions create placeholders for the parameter type description:
Copy external media files into workspace on drop or paste for Markdown
Want to add an image or video into a Markdown document? Instead of wasting time first manually copying the file into your workspace and then adding a link to it, now you can just drop or paste the file into your Markdown. If the file currently isn’t part of the workspace, VS Code will automatically copy the file into your workspace and insert a link to it:
This also works great for image data in the clipboard. For example, if you take a screenshot with the Snipping tool on Windows, you can press Paste in a Markdown file and VS Code will create a new image file from the clipboard data and insert a Markdown image link to the new file. This also works on macOS if you hold the Ctrl key while taking a screenshot to copy it to the clipboard.
You can also customize the behavior of this feature using a few settings:
markdown.copyFiles.destination
The markdown.copyFiles.destination
setting controls where new media files are created. This setting maps globs that match on the current Markdown document to image destinations. The image destinations can also use some simple variables. See the markdown.copyFiles.destination
setting description for information about the available variables.
For example, if we want every Markdown file under /docs
in our workspace to put new media files into an images
directory specific to the current file, we can write:
"markdown.copyFiles.destination": {
"/docs/**/*": "images/${documentBaseName}/"
}
Now when a new file is pasted in /docs/api/readme.md
, the image file is created at /docs/api/images/readme/image.png
.
You can even use simple regular expressions to transform variables in a similar way to snippets. For example, this transform uses only the first letter of the document file name when creating the media file
"markdown.copyFiles.destination": {
"/docs/**/*": "images/${documentBaseName/(.).*/\/}/"
}
When a new file is pasted into /docs/api/readme.md
, the image is now created under /docs/api/images/r/image.png
.
markdown.copyFiles.overwriteBehavior
The markdown.copyFiles.overwriteBehavior
setting controls whether newly created media files overwrite existing files.
By default, VS Code will never overwrite existing files. Instead if you have a file called image.png
and try pasting it into a Markdown document in a workspace where an image.png
already exists, VS Code will instead create a new file called image-1.png
. If you then try pasting another file called image.png
, it will instead be created as image-2.png
.
If you prefer having existing files be overwritten by new files, set "markdown.copyFiles.overwriteBehavior": "overwrite"
. Now VS Code will always use the original file name, overwriting any existing files that that path.
Disabling copying files into the workspace
VS Code will only try copying files into your workspace if they are not already part of workspace. Additionally, we currently only copy media files (images, videos, audio) into the workspace.
However if you find this new behavior too intrusive, you can disable it for both drop and paste by setting:
"markdown.editor.drop.copyIntoWorkspace": "never"
"markdown.editor.filePaste.copyIntoWorkspace": "never"
IntelliSense for HTML paths in Markdown files
Many Markdown dialects allow raw HTML tags to be used in Markdown documents. In this update, we’ve extended most of VS Code’s Markdown IntelliSense features to file paths used in these HTML tags. This includes support for:
Insert audio into Markdown
When you drag and drop or copy and paste an audio file into a Markdown document, VS Code now inserts an <audio>
element.
Syntax highlighting for JSON with Lines (JSONL) files
JSON with Lines describe a sequence of JSON objects separated by newline characters. If the file extension jsonl
is used, VS Code provides syntax highlighting.
Remote Development
The Remote Development extensions, allow you to use a Dev Container, remote machine via SSH or Remote Tunnels, or the Windows Subsystem for Linux (WSL) as a full-featured development environment.
Highlights include:
- Open new Remote connections (via a Remote Tunnel, to a Dev Container) in either the current or a new VS Code window.
- Easier workflow to make a forwarded port public.
- Preliminary support for connecting to WSL from VS Code for the Web (vscode.dev).
You can learn about new extension features and bug fixes in the Remote Development release notes.
Contributions to extensions
GitHub Copilot
Note: To get access to the chat view and inline chat, you’ll need to sign up for the GitHub Copilot chat waitlist.
Use Copilot Chat in Stable VS Code
Previously, you had to use VS Code Insiders to use Copilot Chat. As of VS Code 1.79, you can use Copilot Chat in stable VS Code as well. You will still have to install the GitHub Copilot Nightly extension.
Editor chat
We have improved editor chat, most notably we have changed its default mode to be “livePreview”. In this mode, changes are applied directly to the document and shown with an embedded diff view. Let’s look at the example below:
- A new property was added to the
IUserFriendlyStatusItemEntry
type and - Copilot updated the
isUserFriendlyStatusItemEntry
check accordingly. - The reply is shown in the editor using an embedded diff view. Its right hand side is editable and checked by VS Code’s language extensions.
- This lets you spot an error in the reply (below the
isMarkdownString
function doesn’t exist) and you can fix it before accepting the suggestion.
Notebook improvements
We have improved the chat experience in notebook editors this month. When using Copilot in a notebook document, Copilot can use the notebook context to provide more relevant suggestions. For example, the code suggestions use variables or modules defined in previous cells without recreating or re-importing them.
When running notebook cells, Copilot now also provides suggestions for cell execution failures. You can display these by selecting the Fix using Copilot action on the cell status bar.
The Copilot suggestions are also accepted automatically on cell execution, so you don’t have to accept them manually.
GitHub Pull Request and Issues integration
When the GitHub Pull Requests and Issues extension is installed and enabled and you are viewing a review thread, it is now possible to directly apply a review comment using Copilot. You can do this via the Apply Suggestion with AI button in the comment menu.
Experimental Quick Question experience
Theme: Panda Theme (preview on vscode.dev)
This iteration, we experimented with using chat to ask quick programming questions without leaving context. If you have access to the chat experience, you can enable this feature with the following setting:
"chat.experimental.quickQuestion.enable": true
Feature overview:
- Ask Copilot a quick question.
- Toggle the experience with ⇧⌘I (Windows, Linux Ctrl+Shift+I) (state is remembered for 30s so you can easily show, hide, and show again).
- An Open in chat button for continuing the conversation to a long form chat in the chat view.
Delete chat entry
You can now delete a chat request/response pair by clicking the X icon in the chat request.
Why would you want to do this? Sometimes, Copilot provides a response that is off topic or incorrect. You can ask your question again, but removing the bad response from your session’s chat history may also help keep the conversation on track. There is also a limit to the amount of context that can be included with each chat request, so removing a long poor response might help save your context budget for more useful information.
It was already possible to open a chat session in an editor by running the Chat: Open Editor command, but now it is also possible to move chat sessions back and forth between the sidebar and editor. You can find the Open Session in Editor and Open Session in Sidebar commands under the “…” menu in the chat view title or the editor title menus.
Chat session history
Your chat sessions are now saved to history, which you can browse by selecting the Show History button in the chat view title menu. You can select a history entry to load that conversation into a chat editor, and then seamlessly continue where you left off. You can remove sessions from history by clicking the X button on each row.
Export chat sessions to JSON file
We’ve added a command, Chat: Export Session, which exports the current focused chat session to a JSON file. You can then run the Chat: Import Session command to import this session and continue your conversation. You can check this file into your repo, share it with others, or just save your conversation for reference later. Note that when you are continuing your conversation in an imported chat session, those new messages won’t be saved unless you export the session again.
We’ve added some commands and keybindings that make it easier to work with codeblocks in chat responses. Chat: Next Codeblock (F9) and Chat: Previous Codeblock (⇧F9 (Windows, Linux Shift+F9)) move the cursor to the next or previous codeblock in the current chat response. When a codeblock is focused, the commands in the codeblock toolbar can also be invoked from the Command Palette, or you can assign keybindings to them. Run in Terminal has a keybinding assigned by default, ⌃Enter (Windows, Linux Ctrl+Alt+Enter). And the Copy command will now be run when you press the normal copy keybinding in the codeblock without having a selection.
We’ve also added keybindings to focus the chat window (⌃⌘I (Windows, Linux Ctrl+Alt+I)) and to clear the chat session (⌃L (Windows Win+L, Linux Ctrl+L)).
Copilot YouTube playlist
To learn more about GitHub Copilot as well as tips and tricks and best practices, have a look at the VS Code Copilot Series on YouTube. There you’ll find an introduction to GitHub Copilot, language-specific usage, and guidance on effective prompting when using Copilot for development.
Python
Run Python file in dedicated terminal
The Python extension will now create a new terminal for each file you run using the Run button on the top of the editor or the Python: Run Python File in Terminal command, and will keep using this file’s “dedicated” terminal every time you re-run it.
Any time you wish to run the same file in a separate terminal, you can run select Python: Run Python File in Dedicated Terminal under the Run button menu.
Test discovery and run rewrite
This month, we are beginning the roll out of our testing rewrite as an experiment. This rewrite redesigns the architecture behind test discovery and execution for both unittest and pytest in the extension. While it does not provide any additional functionality exposed to the user, it reduces buggy behavior and opens up new functional opportunities moving forward. The rewrite is being rolled out behind the experiment pythonTestAdapter
, which you can opt in and out of using python.experiments.optInto
in your settings.json
. Eventually, we plan to remove this setting and adopt this new architecture. If you have any comments or suggestions regarding this experiment or rewrite, you can share them in the vscode-python repository.
Configurable indexing limits with Pylance
There’s a new Pylance setting that allows you to configure the file count limit for indexing: "python.analysis.userFileIndexingLimit"
, which is set to 2000 by default. This setting can be helpful when working with very large projects and you’re willing to compromise performance for an enhanced IntelliSense experience.
Jupyter
Resume execution of cells against remote Jupyter kernels
The Jupyter extension now supports resuming execution of cells against remote Jupyter kernels, if the cell is still busy executing, even when reopening the Notebook after having shutdown VS Code.
For instance, assume you execute a long running section of code such as training of a model against a remote Jupyter kernel. This could take a few minutes or longer, so you might decide to shut down VS Code in the interim. A few minutes later VS Code is restarted with the same notebook opened and if the cell is still busy executing, this state is reflected in the Notebook cell and any new output is displayed in the cell output.
If on the other hand, the cell completed execution while VS Code was shut down, the outputs generated in the interim would not be preserved in the notebook. Resuming executions in this manner and displaying new output is limited to simple output such as plain text, HTML, images, images, and the like. Restoring the state of widgets and other such complex outputs is not supported.
GitHub Pull Requests and Issues
There has been more progress on the GitHub Pull Requests and Issues extension, which allows you to work on, create, and manage pull requests and issues. Highlights include:
- Two new actions for viewing diffs of checked out PRs: Compare Base With Pull Request Head (readonly) and Compare Pull Request Head with Local.
- The new setting
"githubPullRequests.pullPullRequestBranchBeforeCheckout"
can be used to turn off pulling a previously checked out PR branch when checking out that same branch again.
Review the changelog for the 0.66.0 release of the extension to learn about the other highlights.
Preview features
Project wide JS/TS IntelliSense on insiders.vscode.dev
vscode.dev is a lightweight version of VS Code running fully in your browser. This iteration, we’ve significantly enriched vscode.dev’s JavaScript and TypeScript support so that it can analyze all files in your workspace instead of being limited to currently opened files. This greatly improves navigation through code, letting you Go to Definition and Find All References to a symbol. It also improves IntelliSense by making sure settings from your tsconfig.json
/ jsconfig.json
are respected. We even now support auto-imports while writing code.
In the image below, the References view is displaying all references to ITextDocument
in the workspace.
These new IntelliSense features work for folders you open from your local machine and in GitHub repos you open using vscode.dev’s built-in GitHub Repositories extension.
Keep in mind that there are still a few limitations with JS/TS IntelliSense on vscode.dev:
- There is not currently IntelliSense support for third party libraries.
- There is not currently support for automatic type acquisition for JavaScript projects.
- Because of the above limitations, all typing errors are disabled on vscode.dev.
- Project wide IntelliSense is currently only enabled on the Insiders version of vscode.dev:
insiders.vscode.dev
. This feature is currently disabled ongithub.dev
.
We plan on addressing these limitations going forward, and are excited to continue enriching our JavaScript and TypeScript support on the web!
Images in the terminal
There is now experimental support for images in the terminal. Images in a terminal typically work by encoding the image pixel data as text, which is written to the terminal via a special escape sequence. The current protocols that are supported are sixel and the inline images protocol pioneered by iTerm.
Enable this feature by setting:
"terminal.integrated.experimentalImageSupport": true
Once enabled, to test it, you can download and cat
a .six
example file from the libsixel repository:
Or use the imgcat python package or imgcat script with a png, gif or jpg file:
The current limitations of this feature are:
TypeScript 5.2 support
This update includes support for the upcoming TypeScript 5.2 release. Check out the TypeScript 5.2 iteration plan for more details about what the TypeScript team is currently working on. Some exciting upcoming tooling highlights include:
- A new Inline constant refactoring.
- A new Move to file refactoring that lets you move a symbol into an existing file.
To start using the TypeScript 5.2 nightly builds, install the TypeScript Nightly extension.
Move to file refactoring for JavaScript and TypeScript
The Move to file refactoring in TypeScript 5.2 nightly lets you move a class, function, or constant into an existing file. This will also automatically update all references to the symbol and also update imports as needed:
When you select Move to file, VS Code shows you a list of all files in the current TypeScript or JavaScript project. You can start typings to quickly find the file you want.
Alternatively, you can use Select existing file… to select a file using the normal file picker or Enter new file path… to specify a new file that should be created.
This feature is still being actively developed, so give it a try and share your feedback!
WebAssemblies in VS Code for the Web
To add more programming language support to vscode.dev, the VS Code team has been investigating how to run general WebAssembly in VS Code for the Web. If you are interested in this approach and want to learn more, check out the recent VS Code and WebAssemblies blog post.
Improved vscode.fs performance for local files
When you are using vscode.fs
API to work with files (you should!), operations to files that are local to the extension host will now resolve much faster.
Previously the extension host would delegate these operations to the VS Code client for execution, but now they execute directly inside the extension host, saving round trips.
Stricter Status bar API
The API to create a Status bar item createStatusBarItem
lets extensions pass an identifier. This identifier is used to control hiding and showing the Status bar item. The identifier should be unique for the extension but until now this wasn’t enforced. With this release, we make this a little more strict and Status bar items that are created by the same extension with the same identifier will now be merged into one.
Tasks
The task presentation option to close the terminal on task completion has been finalized.
Proposed APIs
Every milestone comes with new proposed APIs and extension authors can try them out. As always, we want your feedback. Here are the steps to try out a proposed API:
- Find a proposal that you want to try and add its name to
package.json#enabledApiProposals
. - Use the latest @vscode/dts and run
npx @vscode/dts dev
. It will download the correspondingd.ts
files into your workspace. - You can now program against the proposal.
You cannot publish an extension that uses a proposed API. There may be breaking changes in the next release and we never want to break existing extensions.
EnvironmentVariableCollection.description
This proposal allows specifying a description for EnvironmentVariableCollection
, displayed to the user in the terminal tab hover, explaining what exactly the change is doing.
// Example of what the Git extension could use
context.environmentVariableCollection.description = 'Enables a Git authentication provider';
EnvironmentVariableMutator.options
This proposal adds options that can be provided to EnvironmentVariableMutator
s, allowing you to specify exactly when the environment variable change is applied, either on process creation or in the shell integration script (after shell init scripts have run).
const collection = context.environmentVariableCollection;
// Apply only when the process is created
collection.replace('FOO', 'bar');
// Apply only during the shell integration script
collection.replace('FOO', 'bar', {
applyAtProcessCreation: false,
applyAtShellIntegration: true
});
// Apply twice, during process creation and the shell integration script
collection.replace('FOO', 'bar', {
applyAtProcessCreation: true,
applyAtShellIntegration: true
});
The Share API proposal allows extensions to provide ways to share resources in VS Code.
Share provider results are currently surfaced as a top-level Share… Command Palette action and as a new icon near the Command Center, provided you have opted in with "workbench.experimental.share.enabled": true
and "window.commandCenter": true
.
You can leave feedback in the API proposal issue #176316.
Static Status bar items
Status bar items can now be contributed statically via package.json#contributes/statusBarItems
. With this contribution point, an extension can delay its activation and only activate when the Status bar item is interacted with, for example, on the command. Once activated, extensions can access their static Status bar items via the vscode.window.createStatusBarItem
API.
workspace.save and workspace.saveAs
The Save Editor API proposal allows extensions to trigger the flow of saving an editor either to its resource or by asking the user to provide a resource.
All the methods for saving will return the resulting Uri
or undefined
if the operation was canceled. Untitled files will always ask the user for a destination unless a path is already associated.
Authentication authGetSessions proposed API
As we move closer to having Multiple GitHub account support, we have a new proposed authentication API that lets your extension get all accessible sessions for a specific set of scopes. The proposal for these API additions has several things to call out:
- The introduction of
vscode.authentication.getSessions
to get sessions for each account that your extension has access to. If you want to request an additional account, use{ createIfNone: true, clearSessionPreference: true }
to ask the user to choose an account. - The
forceNewSession
property now can take in a{ sessionToRecreate: session }
object so that consuming extensions can specify the exact session they want to be recreated. - The
createSession
function that an Auth Provider implements will now get passed in the session to recreate (using the extension’s session preference iftrue
is used for the value offorceNewSession
).
There is still more work involved to make this ready for adoption in the GitHub Authentication extension so if you’re interested, you can follow along and provide feedback in the issue that tracks this proposal.
Window Activity API
A new API is available to notify extensions if the window becomes active or inactive. This can be used to dispose of or create persistent resources or processes that can be idled to save resources.
This is implemented by the addition of a new active
boolean to the existing WindowState
type.
vscode.window.onDidChangeWindowState(state => {
if (state.active && !longRunningProcess) {
longRunningProcess = startLongRunningProcess();
} else if (!state.active && longRunningProcess) {
longRunningProcess.end();
longRunningProcess = undefined;
}
});
Engineering
Electron sandbox enabled for all users
We are happy to announce that the Electron sandbox is rolling out to all of our users. This was a journey that started in early 2020 and now finally comes to an end. You can refer to the Migrating VS Code to Process Sandboxing blog post for more details.
Extension host restart participation
Certain actions in the workbench can lead to the extension host restarting without reloading the current window. For example, when you switch profiles, VS Code restarts the extension host to handle running a different set of extensions for that profile.
Some custom and notebook editors however may no longer be functional after having switched profiles because a required extension is not installed in that profile. If the editor has unsaved changes, this could cause data loss. As a fix, components in VS Code can now participate in extension host restarts and make sure any unsaved changes are saved before the extension host restarts.
We plan to further develop this experience in the next milestone so stay tuned for more!
Windows 8 and 8.1 support has ended
As mentioned in our v1.77 release notes, v1.79
is the last release that supports Windows 8 / Windows Server 2012 and Windows 8.1 / Windows Server 2012 R2. Refer to our FAQ for additional information.
Milestone automation
We have implemented automated milestone replication throughout all of our GitHub repositories. This means that the monthly milestones established in microsoft/vscode
serve as the foundation for all other milestones that are created and maintained.
VS Code at Microsoft Build
If you didn’t get a chance to watch Microsoft Build 2023 live, you can catch up on the keynotes and sessions on the Microsoft Developer YouTube channel.
Some sessions of particular interest to VS Code users include:
Notable fixes
- 165933 [emmet] http-equiv=”X-UA-Compatible” in 2023
- 181889 treeView.reveal with expand: 3 only expands the first level 3 folder
Thank you
Last but certainly not least, a big Thank You to the contributors of VS Code.
Issue tracking
Contributions to our issue tracking:
Pull requests
Contributions to vscode
:
Contributions to vscode-css-languageservice
:
Contributions to vscode-js-debug
:
Contributions to vscode-pull-request-github
:
Contributions to monaco-editor
: