<!doctype html>
< html class = "default no-js" >
< head >
< meta charset = "utf-8" >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" >
< title > WorkspaceConfiguration | VS Code API 中文文档< / title >
< meta name = "description" content = "Documentation for VS Code API 中文文档" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
< link rel = "shortcut icon" href = "https://code.visualstudio.com/favicon.ico" sizes = "128x128" >
< link rel = "stylesheet" href = "../assets/css/main.css" >
< script async src = "../assets/js/search.js" id = "search-script" > < / script >
< script async src = "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-7962287588031867"
crossorigin="anonymous">< / script >
< style >
a[title="站长统计"] {
display: none;
}
.github-corner svg {
z-index: 1;
}
.github-corner:hover .octo-arm {
animation:octocat-wave 560ms ease-in-out
}
@keyframes octocat-wave {
0%,100%{transform:rotate(0)}
20%,60%{transform:rotate(-25deg)}
40%,80%{transform:rotate(10deg)}
}
@media (max-width:500px) {
.github-corner:hover
.octo-arm{animation:none}
.github-corner .octo-arm{
animation:octocat-wave 560ms ease-in-out
}
}
.container-main {
padding-bottom: 50px;
}
< / style >
< / head >
< body >
< header >
< div class = "tsd-page-toolbar" >
< div class = "container" >
< div class = "table-wrap" >
< div class = "table-cell" id = "tsd-search" data-index = "../assets/js/search.json" data-base = ".." >
< div class = "field" >
< label for = "tsd-search-field" class = "tsd-widget search no-caption" > Search< / label >
< input id = "tsd-search-field" type = "text" / >
< / div >
< ul class = "results" >
< li class = "state loading" > Preparing search index...< / li >
< li class = "state failure" > The search index is not available< / li >
< / ul >
< a href = "../index.html" class = "title" > VS Code API 中文文档< / a >
< / div >
< div class = "table-cell" id = "tsd-widgets" >
< div id = "tsd-filter" >
< a href = "#" class = "tsd-widget options no-caption" data-toggle = "options" > Options< / a >
< div class = "tsd-filter-group" >
< div class = "tsd-select" id = "tsd-filter-visibility" >
< span class = "tsd-select-label" > All< / span >
< ul class = "tsd-select-list" >
< li data-value = "public" > Public< / li >
< li data-value = "protected" > Public/Protected< / li >
< li data-value = "private" class = "selected" > All< / li >
< / ul >
< / div >
< input type = "checkbox" id = "tsd-filter-inherited" checked / >
< label class = "tsd-widget" for = "tsd-filter-inherited" > Inherited< / label >
< input type = "checkbox" id = "tsd-filter-externals" checked / >
< label class = "tsd-widget" for = "tsd-filter-externals" > Externals< / label >
< / div >
< / div >
< a href = "#" class = "tsd-widget menu no-caption" data-toggle = "menu" > Menu< / a >
< / div >
< / div >
< / div >
< / div >
< div class = "tsd-page-title" >
< div class = "container" >
< ul class = "tsd-breadcrumb" >
< li >
< a href = "../modules.html" > VS Code API 中文文档< / a >
< / li >
< li >
< a href = "../modules/vscode.html" > vscode< / a >
< / li >
< li >
< a href = "vscode.WorkspaceConfiguration.html" > WorkspaceConfiguration< / a >
< / li >
< / ul >
< h1 > Interface WorkspaceConfiguration< / h1 >
< / div >
< / div >
< / header >
< div class = "container container-main" >
< div class = "row" >
< div class = "col-8 col-content" >
< section class = "tsd-panel tsd-comment" >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Represents the configuration. It is a merged view of< / p >
< / div >
< ul >
< li > < em > Default Settings< / em > < / li >
< li > < em > Global (User) Settings< / em > < / li >
< li > < em > Workspace settings< / em > < / li >
< li > < em > Workspace Folder settings< / em > - From one of the < a href = "../modules/vscode.workspace.html#workspaceFolders" > Workspace Folders< / a > under which requested resource belongs to.< / li >
< li > < em > Language settings< / em > - Settings defined under requested language.< / li >
< / ul >
< p > The < em > effective< / em > value (returned by < a href = "vscode.WorkspaceConfiguration.html#get" > < code > get< / code > < / a > ) is computed by overriding or merging the values in the following order.< / p >
< pre > < code > < span style = "color: #A31515" > `defaultValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > < / span > < span style = "color: #0000FF" > in< / span > < span style = "color: #000000" > < / span > < span style = "color: #A31515" > `package.json`< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > otherwise< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > derived< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > from< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > the< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > value< / span > < span style = "color: #A31515" > ' s type< / span > < span style = "color: #CD3131" > )< / span >
< span style = "color: #A31515" > `globalValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< span style = "color: #A31515" > `workspaceValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< span style = "color: #A31515" > `workspaceFolderValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< span style = "color: #A31515" > `defaultLanguageValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< span style = "color: #A31515" > `globalLanguageValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< span style = "color: #A31515" > `workspaceLanguageValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< span style = "color: #A31515" > `workspaceFolderLanguageValue`< / span > < span style = "color: #000000" > (< / span > < span style = "color: #001080" > if< / span > < span style = "color: #000000" > < / span > < span style = "color: #001080" > defined< / span > < span style = "color: #000000" > )< / span >
< / code > < / pre >
< p > < strong > Note:< / strong > Only < code > object< / code > value types are merged and all other value types are overridden.< / p >
< p > Example 1: Overriding< / p >
< pre > < code class = "language-ts" > < span style = "color: #001080" > defaultValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' on' < / span > < span style = "color: #000000" > ;< / span >
< span style = "color: #001080" > globalValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' relative' < / span >
< span style = "color: #001080" > workspaceFolderValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' off' < / span >
< span style = "color: #001080" > value< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' off' < / span >
< / code > < / pre >
< p > Example 2: Language Values< / p >
< pre > < code class = "language-ts" > < span style = "color: #001080" > defaultValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' on' < / span > < span style = "color: #000000" > ;< / span >
< span style = "color: #001080" > globalValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' relative' < / span >
< span style = "color: #001080" > workspaceFolderValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' off' < / span >
< span style = "color: #001080" > globalLanguageValue< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' on' < / span >
< span style = "color: #001080" > value< / span > < span style = "color: #000000" > = < / span > < span style = "color: #A31515" > ' on' < / span >
< / code > < / pre >
< p > Example 3: Object Values< / p >
< pre > < code class = "language-ts" > < span style = "color: #001080" > defaultValue< / span > < span style = "color: #000000" > = { < / span > < span style = "color: #A31515" > " a" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 1< / span > < span style = "color: #000000" > , < / span > < span style = "color: #A31515" > " b" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 2< / span > < span style = "color: #000000" > };< / span >
< span style = "color: #001080" > globalValue< / span > < span style = "color: #000000" > = { < / span > < span style = "color: #A31515" > " b" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 3< / span > < span style = "color: #000000" > , < / span > < span style = "color: #A31515" > " c" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 4< / span > < span style = "color: #000000" > };< / span >
< span style = "color: #001080" > value< / span > < span style = "color: #000000" > = { < / span > < span style = "color: #A31515" > " a" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 1< / span > < span style = "color: #000000" > , < / span > < span style = "color: #A31515" > " b" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 3< / span > < span style = "color: #000000" > , < / span > < span style = "color: #A31515" > " c" < / span > < span style = "color: #001080" > :< / span > < span style = "color: #000000" > < / span > < span style = "color: #098658" > 4< / span > < span style = "color: #000000" > };< / span >
< / code > < / pre >
< p > < em > Note:< / em > Workspace and Workspace Folder configurations contains < code > launch< / code > and < code > tasks< / code > settings. Their basename will be
part of the section identifier. The following snippets shows how to retrieve all configurations
from < code > launch.json< / code > :< / p >
< pre > < code class = "language-ts" > < span style = "color: #008000" > // launch.json configuration< / span >
< span style = "color: #0000FF" > const< / span > < span style = "color: #000000" > < / span > < span style = "color: #0070C1" > config< / span > < span style = "color: #000000" > = < / span > < span style = "color: #001080" > workspace< / span > < span style = "color: #000000" > .< / span > < span style = "color: #795E26" > getConfiguration< / span > < span style = "color: #000000" > (< / span > < span style = "color: #A31515" > ' launch' < / span > < span style = "color: #000000" > , < / span > < span style = "color: #001080" > vscode< / span > < span style = "color: #000000" > .< / span > < span style = "color: #001080" > workspace< / span > < span style = "color: #000000" > .< / span > < span style = "color: #001080" > workspaceFolders< / span > < span style = "color: #000000" > [< / span > < span style = "color: #098658" > 0< / span > < span style = "color: #000000" > ].< / span > < span style = "color: #001080" > uri< / span > < span style = "color: #000000" > );< / span >
< span style = "color: #008000" > // retrieve values< / span >
< span style = "color: #0000FF" > const< / span > < span style = "color: #000000" > < / span > < span style = "color: #0070C1" > values< / span > < span style = "color: #000000" > = < / span > < span style = "color: #001080" > config< / span > < span style = "color: #000000" > .< / span > < span style = "color: #795E26" > get< / span > < span style = "color: #000000" > (< / span > < span style = "color: #A31515" > ' configurations' < / span > < span style = "color: #000000" > );< / span >
< / code > < / pre >
< p > Refer to < a href = "https://code.visualstudio.com/docs/getstarted/settings" > Settings< / a > for more information.< / p >
< / div >
< / section >
< section class = "tsd-panel tsd-hierarchy" >
< h3 > 层级< / h3 >
< ul class = "tsd-hierarchy" >
< li >
< span class = "target" > WorkspaceConfiguration< / span >
< / li >
< / ul >
< / section >
< section class = "tsd-panel tsd-kind-interface tsd-parent-kind-namespace" >
< h3 class = "tsd-before-signature" > Indexable< / h3 >
< div class = "tsd-signature tsd-kind-icon" > < span class = "tsd-signature-symbol" > [< / span > key: < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > ]: < / span > < span class = "tsd-signature-type" > any< / span > < / div >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Readable dictionary that backs this configuration.< / p >
< / div >
< / div >
< / section >
< section class = "tsd-panel-group tsd-index-group" >
< h2 > 索引< / h2 >
< section class = "tsd-panel tsd-index-panel" >
< div class = "tsd-index-content" >
< section class = "tsd-index-section " >
< h3 > Methods（ ） < / h3 >
< ul class = "tsd-index-list" >
< li class = "tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" > < a href = "vscode.WorkspaceConfiguration.html#get" class = "tsd-kind-icon" > get< / a > < / li >
< li class = "tsd-kind-method tsd-parent-kind-interface" > < a href = "vscode.WorkspaceConfiguration.html#has" class = "tsd-kind-icon" > has< / a > < / li >
< li class = "tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" > < a href = "vscode.WorkspaceConfiguration.html#inspect" class = "tsd-kind-icon" > inspect< / a > < / li >
< li class = "tsd-kind-method tsd-parent-kind-interface" > < a href = "vscode.WorkspaceConfiguration.html#update" class = "tsd-kind-icon" > update< / a > < / li >
< / ul >
< / section >
< / div >
< / section >
< / section >
< section class = "tsd-panel-group tsd-member-group " >
< h2 > Methods（ ） < / h2 >
< section class = "tsd-panel tsd-member tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" >
< a name = "get" class = "tsd-anchor" > < / a >
< h3 > get< / h3 >
< ul class = "tsd-signatures tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" >
< li class = "tsd-signature tsd-kind-icon" > get< T> < span class = "tsd-signature-symbol" > (< / span > section< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > )< / span > < span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > undefined< / span > < span class = "tsd-signature-symbol" > | < / span > < span class = "tsd-signature-type" > T< / span > < / li >
< li class = "tsd-signature tsd-kind-icon" > get< T> < span class = "tsd-signature-symbol" > (< / span > section< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > , defaultValue< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > )< / span > < span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > T< / span > < / li >
< / ul >
< ul class = "tsd-descriptions" >
< li class = "tsd-description" >
< aside class = "tsd-sources" >
< ul >
< li > Defined in < a href = "https://github.com/vscode-cn/vscode-api-cn/blob/7f893c8/vscode.d.ts#L5098" > vscode.d.ts:5098< / a > < / li >
< / ul >
< / aside >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Return a value from this configuration.< / p >
< / div >
< / div >
< h4 class = "tsd-type-parameters-title" > Type parameters< / h4 >
< ul class = "tsd-type-parameters" >
< li >
< h4 > T< / h4 >
< / li >
< / ul >
< h4 class = "tsd-parameters-title" > Parameters< / h4 >
< ul class = "tsd-parameters" >
< li >
< h5 > section: < span class = "tsd-signature-type" > string< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > Configuration name, supports < em > dotted< / em > names.< / p >
< / div >
< / li >
< / ul >
< h4 class = "tsd-returns-title" > Returns < span class = "tsd-signature-type" > undefined< / span > < span class = "tsd-signature-symbol" > | < / span > < span class = "tsd-signature-type" > T< / span > < / h4 >
< p > The value < code > section< / code > denotes or < code > undefined< / code > .< / p >
< / li >
< li class = "tsd-description" >
< aside class = "tsd-sources" >
< ul >
< li > Defined in < a href = "https://github.com/vscode-cn/vscode-api-cn/blob/7f893c8/vscode.d.ts#L5107" > vscode.d.ts:5107< / a > < / li >
< / ul >
< / aside >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Return a value from this configuration.< / p >
< / div >
< / div >
< h4 class = "tsd-type-parameters-title" > Type parameters< / h4 >
< ul class = "tsd-type-parameters" >
< li >
< h4 > T< / h4 >
< / li >
< / ul >
< h4 class = "tsd-parameters-title" > Parameters< / h4 >
< ul class = "tsd-parameters" >
< li >
< h5 > section: < span class = "tsd-signature-type" > string< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > Configuration name, supports < em > dotted< / em > names.< / p >
< / div >
< / li >
< li >
< h5 > defaultValue: < span class = "tsd-signature-type" > T< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > A value should be returned when no value could be found, is < code > undefined< / code > .< / p >
< / div >
< / li >
< / ul >
< h4 class = "tsd-returns-title" > Returns < span class = "tsd-signature-type" > T< / span > < / h4 >
< p > The value < code > section< / code > denotes or the default.< / p >
< / li >
< / ul >
< / section >
< section class = "tsd-panel tsd-member tsd-kind-method tsd-parent-kind-interface" >
< a name = "has" class = "tsd-anchor" > < / a >
< h3 > has< / h3 >
< ul class = "tsd-signatures tsd-kind-method tsd-parent-kind-interface" >
< li class = "tsd-signature tsd-kind-icon" > has< span class = "tsd-signature-symbol" > (< / span > section< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > )< / span > < span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > boolean< / span > < / li >
< / ul >
< ul class = "tsd-descriptions" >
< li class = "tsd-description" >
< aside class = "tsd-sources" >
< ul >
< li > Defined in < a href = "https://github.com/vscode-cn/vscode-api-cn/blob/7f893c8/vscode.d.ts#L5115" > vscode.d.ts:5115< / a > < / li >
< / ul >
< / aside >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Check if this configuration has a certain value.< / p >
< / div >
< / div >
< h4 class = "tsd-parameters-title" > Parameters< / h4 >
< ul class = "tsd-parameters" >
< li >
< h5 > section: < span class = "tsd-signature-type" > string< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > Configuration name, supports < em > dotted< / em > names.< / p >
< / div >
< / li >
< / ul >
< h4 class = "tsd-returns-title" > Returns < span class = "tsd-signature-type" > boolean< / span > < / h4 >
< p > < code > true< / code > if the section doesn' t resolve to < code > undefined< / code > .< / p >
< / li >
< / ul >
< / section >
< section class = "tsd-panel tsd-member tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" >
< a name = "inspect" class = "tsd-anchor" > < / a >
< h3 > inspect< / h3 >
< ul class = "tsd-signatures tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" >
< li class = "tsd-signature tsd-kind-icon" > inspect< T> < span class = "tsd-signature-symbol" > (< / span > section< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > )< / span > < span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > undefined< / span > < span class = "tsd-signature-symbol" > | < / span > < span class = "tsd-signature-symbol" > { < / span > key< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > ; < / span > defaultValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > globalValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceFolderValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > defaultLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > globalLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceFolderLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > languageIds< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > []< / span > < span class = "tsd-signature-symbol" > }< / span > < / li >
< / ul >
< ul class = "tsd-descriptions" >
< li class = "tsd-description" >
< aside class = "tsd-sources" >
< ul >
< li > Defined in < a href = "https://github.com/vscode-cn/vscode-api-cn/blob/7f893c8/vscode.d.ts#L5131" > vscode.d.ts:5131< / a > < / li >
< / ul >
< / aside >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Retrieve all information about a configuration setting. A configuration value
often consists of a < em > default< / em > value, a global or installation-wide value,
a workspace-specific value, folder-specific value
and language-specific values (if < a href = "vscode.WorkspaceConfiguration.html" > WorkspaceConfiguration< / a > is scoped to a language).< / p >
< / div >
< p > Also provides all language ids under which the given configuration setting is defined.< / p >
< p > < em > Note:< / em > The configuration name must denote a leaf in the configuration tree
(< code > editor.fontSize< / code > vs < code > editor< / code > ) otherwise no result is returned.< / p >
< / div >
< h4 class = "tsd-type-parameters-title" > Type parameters< / h4 >
< ul class = "tsd-type-parameters" >
< li >
< h4 > T< / h4 >
< / li >
< / ul >
< h4 class = "tsd-parameters-title" > Parameters< / h4 >
< ul class = "tsd-parameters" >
< li >
< h5 > section: < span class = "tsd-signature-type" > string< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > Configuration name, supports < em > dotted< / em > names.< / p >
< / div >
< / li >
< / ul >
< h4 class = "tsd-returns-title" > Returns < span class = "tsd-signature-type" > undefined< / span > < span class = "tsd-signature-symbol" > | < / span > < span class = "tsd-signature-symbol" > { < / span > key< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > ; < / span > defaultValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > globalValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceFolderValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > defaultLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > globalLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > workspaceFolderLanguageValue< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > T< / span > < span class = "tsd-signature-symbol" > ; < / span > languageIds< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > string< / span > < span class = "tsd-signature-symbol" > []< / span > < span class = "tsd-signature-symbol" > }< / span > < / h4 >
< p > Information about a configuration setting or < code > undefined< / code > .< / p >
< / li >
< / ul >
< / section >
< section class = "tsd-panel tsd-member tsd-kind-method tsd-parent-kind-interface" >
< a name = "update" class = "tsd-anchor" > < / a >
< h3 > update< / h3 >
< ul class = "tsd-signatures tsd-kind-method tsd-parent-kind-interface" >
< li class = "tsd-signature tsd-kind-icon" > update< span class = "tsd-signature-symbol" > (< / span > section< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > string< / span > , value< span class = "tsd-signature-symbol" > : < / span > < span class = "tsd-signature-type" > any< / span > , configurationTarget< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > null< / span > < span class = "tsd-signature-symbol" > | < / span > < span class = "tsd-signature-type" > boolean< / span > < span class = "tsd-signature-symbol" > | < / span > < a href = "../enums/vscode.ConfigurationTarget.html" class = "tsd-signature-type" data-tsd-kind = "Enumeration" > ConfigurationTarget< / a > , overrideInLanguage< span class = "tsd-signature-symbol" > ?: < / span > < span class = "tsd-signature-type" > boolean< / span > < span class = "tsd-signature-symbol" > )< / span > < span class = "tsd-signature-symbol" > : < / span > < a href = "Thenable.html" class = "tsd-signature-type" data-tsd-kind = "Interface" > Thenable< / a > < span class = "tsd-signature-symbol" > < < / span > < span class = "tsd-signature-type" > void< / span > < span class = "tsd-signature-symbol" > > < / span > < / li >
< / ul >
< ul class = "tsd-descriptions" >
< li class = "tsd-description" >
< aside class = "tsd-sources" >
< ul >
< li > Defined in < a href = "https://github.com/vscode-cn/vscode-api-cn/blob/7f893c8/vscode.d.ts#L5177" > vscode.d.ts:5177< / a > < / li >
< / ul >
< / aside >
< div class = "tsd-comment tsd-typography" >
< div class = "lead" >
< p > Update a configuration value. The updated configuration values are persisted.< / p >
< / div >
< p > A value can be changed in< / p >
< ul >
< li > < a href = "../enums/vscode.ConfigurationTarget.html#Global" > Global settings< / a > : Changes the value for all instances of the editor.< / li >
< li > < a href = "../enums/vscode.ConfigurationTarget.html#Workspace" > Workspace settings< / a > : Changes the value for current workspace, if available.< / li >
< li > < a href = "../enums/vscode.ConfigurationTarget.html#WorkspaceFolder" > Workspace folder settings< / a > : Changes the value for settings from one of the < a href = "../modules/vscode.workspace.html#workspaceFolders" > Workspace Folders< / a > under which the requested resource belongs to.< / li >
< li > Language settings: Changes the value for the requested languageId.< / li >
< / ul >
< p > < em > Note:< / em > To remove a configuration value use < code > undefined< / code > , like so: < code > config.update(' somekey' , undefined)< / code > < / p >
< dl class = "tsd-comment-tags" >
< dt > throws< / dt >
< dd > < p > error while updating
- configuration which is not registered.
- window configuration to workspace folder
- configuration to workspace or workspace folder when no workspace is opened.
- configuration to workspace folder when there is no workspace folder settings.
- configuration to workspace folder when < a href = "vscode.WorkspaceConfiguration.html" > WorkspaceConfiguration< / a > is not scoped to a resource.< / p >
< / dd >
< / dl >
< / div >
< h4 class = "tsd-parameters-title" > Parameters< / h4 >
< ul class = "tsd-parameters" >
< li >
< h5 > section: < span class = "tsd-signature-type" > string< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > Configuration name, supports < em > dotted< / em > names.< / p >
< / div >
< / li >
< li >
< h5 > value: < span class = "tsd-signature-type" > any< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > The new value.< / p >
< / div >
< / li >
< li >
< h5 > < span class = "tsd-flag ts-flagOptional" > Optional< / span > configurationTarget: < span class = "tsd-signature-type" > null< / span > < span class = "tsd-signature-symbol" > | < / span > < span class = "tsd-signature-type" > boolean< / span > < span class = "tsd-signature-symbol" > | < / span > < a href = "../enums/vscode.ConfigurationTarget.html" class = "tsd-signature-type" data-tsd-kind = "Enumeration" > ConfigurationTarget< / a > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > The < a href = "../enums/vscode.ConfigurationTarget.html" > configuration target< / a > or a boolean value.
- If < code > true< / code > updates < a href = "../enums/vscode.ConfigurationTarget.html#Global" > Global settings< / a > .
- If < code > false< / code > updates < a href = "../enums/vscode.ConfigurationTarget.html#Workspace" > Workspace settings< / a > .
- If < code > undefined< / code > or < code > null< / code > updates to < a href = "../enums/vscode.ConfigurationTarget.html#WorkspaceFolder" > Workspace folder settings< / a > if configuration is resource specific,
otherwise to < a href = "../enums/vscode.ConfigurationTarget.html#Workspace" > Workspace settings< / a > .< / p >
< / div >
< / li >
< li >
< h5 > < span class = "tsd-flag ts-flagOptional" > Optional< / span > overrideInLanguage: < span class = "tsd-signature-type" > boolean< / span > < / h5 >
< div class = "tsd-comment tsd-typography" >
< p > Whether to update the value in the scope of requested languageId or not.
- If < code > true< / code > updates the value under the requested languageId.
- If < code > undefined< / code > updates the value under the requested languageId only if the configuration is defined for the language.< / p >
< / div >
< / li >
< / ul >
< h4 class = "tsd-returns-title" > Returns < a href = "Thenable.html" class = "tsd-signature-type" data-tsd-kind = "Interface" > Thenable< / a > < span class = "tsd-signature-symbol" > < < / span > < span class = "tsd-signature-type" > void< / span > < span class = "tsd-signature-symbol" > > < / span > < / h4 >
< / li >
< / ul >
< / section >
< / section >
< / div >
< div class = "col-4 col-menu menu-sticky-wrap menu-highlight" >
< nav class = "tsd-navigation primary" >
< ul >
< li class = " " >
< a href = "../modules.html" > Exports< / a >
< / li >
< li class = "current tsd-kind-namespace" >
< a href = "../modules/vscode.html" > vscode< / a >
< ul >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.authentication.html" > authentication< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.commands.html" > commands< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.comments.html" > comments< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.debug.html" > debug< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.env.html" > env< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.extensions.html" > extensions< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.languages.html" > languages< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.notebooks.html" > notebooks< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.scm.html" > scm< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.tasks.html" > tasks< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.tests.html" > tests< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.window.html" > window< / a >
< / li >
< li class = " tsd-kind-namespace tsd-parent-kind-namespace" >
< a href = "../modules/vscode.workspace.html" > workspace< / a >
< / li >
< / ul >
< / li >
< / ul >
< / nav >
< nav class = "tsd-navigation secondary menu-sticky" >
< ul class = "before-current" >
< / ul >
< ul class = "current" >
< li class = "current tsd-kind-interface tsd-parent-kind-namespace" >
< a href = "vscode.WorkspaceConfiguration.html" class = "tsd-kind-icon" > Workspace< wbr > Configuration< / a >
< ul >
< li class = " tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" >
< a href = "vscode.WorkspaceConfiguration.html#get" class = "tsd-kind-icon" > get< / a >
< / li >
< li class = " tsd-kind-method tsd-parent-kind-interface" >
< a href = "vscode.WorkspaceConfiguration.html#has" class = "tsd-kind-icon" > has< / a >
< / li >
< li class = " tsd-kind-method tsd-parent-kind-interface tsd-has-type-parameter" >
< a href = "vscode.WorkspaceConfiguration.html#inspect" class = "tsd-kind-icon" > inspect< / a >
< / li >
< li class = " tsd-kind-method tsd-parent-kind-interface" >
< a href = "vscode.WorkspaceConfiguration.html#update" class = "tsd-kind-icon" > update< / a >
< / li >
< / ul >
< / li >
< / ul >
< ul class = "after-current" >
< / ul >
< / nav >
< / div >
< / div >
< / div >
< footer class = "with-border-bottom" >
< div class = "container" >
< h2 > 图例< / h2 >
< div class = "tsd-legend-group" >
< ul class = "tsd-legend" >
< li class = "tsd-kind-method tsd-parent-kind-interface" > < span class = "tsd-kind-icon" > Method< / span > < / li >
< / ul >
< / div >
< / div >
< / footer >
< div class = "container tsd-generator" >
< p > < a href = "https://liiked.github.io/VS-Code-Extension-Doc-ZH/" target = "_blank" > VS Code 插件开发中文文档< / a > | < a href = "https://jeasonstudio.gitbooks.io/vscode-cn-doc/content/" target = "_blank" > VS Code 中文文档< / a > | < a href = "https://code.visualstudio.com/docs" target = "_blank" > VS Code 官网文档< / a > | < a href = "https://marketplace.visualstudio.com/" target = "_blank" > VS Code 扩展市场< / a > < / p >
< p > Generated by < a href = "https://typedoc.org/" target = "_blank" > TypeDoc< / a > | < a href = "https://www.cnzz.com/stat/website.php?web_id=1280241129" target = "_blank" title = "VS Code 官网文档站长统计" > 站长统计< / a > < / p >
< / div >
< div class = "overlay" > < / div >
< script src = "../assets/js/main.js" > < / script >
< script type = "text/javascript" > document . write ( unescape ( "%3Cspan id='cnzz_stat_icon_1280241129'%3E%3C/span%3E%3Cscript src='https://s9.cnzz.com/z_stat.php%3Fid%3D1280241129' type='text/javascript'%3E%3C/script%3E" ) ) ; < / script >
< a href = "https://github.com/youngjuning/vscode-api-cn" target = "_blank" class = "github-corner" aria-label = "View source on GitHub" > < svg width = "80" height = "80" viewBox = "0 0 250 250" style = "fill:#151513; color:#fff; position: fixed; top: 0; border: 0; right: 0;" aria-hidden = "true" > < path d = "M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z" > < / path > < path d = "M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill = "currentColor" style = "transform-origin: 130px 106px;" class = "octo-arm" > < / path > < path d = "M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill = "currentColor" class = "octo-body" > < / path > < / svg > < / a >
< / body >
< / html >
