prettier を 2.x から 3.x へアップグレード

prettier 2.8.8 と 3.9.9 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	12
削除されたエクスポート	2
変更されたシグネチャ	14
削除されたクラス／インターフェースのメンバー	16
変更されたクラス／インターフェースのメンバー	33
新たに非推奨	2
要件の変更（engines、peer 依存関係）	1
新しいエクスポート	1

削除されたインポートパス

削除されたインポートパス
`prettier/parser-flow`
`prettier/parser-html`
`prettier/parser-yaml`
`prettier/parser-babel`
`prettier/parser-espree`
`prettier/parser-angular`
`prettier/parser-glimmer`
`prettier/parser-graphql`
`prettier/parser-meriyah`
`prettier/parser-postcss`
`prettier/parser-markdown`
`prettier/parser-typescript`

削除されたエクスポート

import	export	kind	変更前
`prettier`	`CustomParser`	type	`(text: string, parsers: BuiltInParsers, options: Options) => any`
`prettier/doc`	`debug`	namespace	`namespace`

変更されたシグネチャ

export	変更前	変更後
`prettier · check`	`(source: string, options?: Options \| undefined): boolean`	`(source: string, options?: Options \| undefined): Promise<boolean>`
`prettier · format`	`(source: string, options?: Options \| undefined): string`	`(source: string, options?: Options \| undefined): Promise<string>`
`prettier · getFileInfo`	`(filePath: string, options?: FileInfoOptions \| undefined): Promise<FileInfoResult>`	`(file: string \| URL, options?: FileInfoOptions \| undefined): Promise<FileInfoResult>`
`prettier · resolveConfig`	`(filePath: string, options?: ResolveConfigOptions \| undefined): Promise<Options \| null>`	`(fileUrlOrPath: string \| URL, options?: ResolveConfigOptions \| undefined): Promise<Options \| null>`
`prettier · BuiltInParsers`	{ angular: BuiltInParser; "babel-flow": BuiltInParser; "babel-ts": BuiltInParser; babel: BuiltInParser; css: BuiltInParser; espree: BuiltInParser; flow: BuiltInParser; glimmer: BuiltInParser; graphql: BuiltInParser; html: BuiltInParser; "json-stringify": BuiltInParser; json: BuiltInParser; json5: BuiltInParser; less: BuiltInParser; lwc: BuiltInParser; markdown: BuiltInParser; mdx: BuiltInParser; meriyah: BuiltInParser; scss: BuiltInParser; typescript: BuiltInParser; vue: BuiltInParser; yaml: BuiltInParser; }	{ acorn: BuiltInParser; angular: BuiltInParser; "babel-flow": BuiltInParser; "babel-ts": BuiltInParser; babel: BuiltInParser; css: BuiltInParser; espree: BuiltInParser; flow: BuiltInParser; glimmer: BuiltInParser; graphql: BuiltInParser; html: BuiltInParser; "json-stringify": BuiltInParser; json: BuiltInParser; json5: BuiltInParser; jsonc: BuiltInParser; less: BuiltInParser; lwc: BuiltInParser; markdown: BuiltInParser; mdx: BuiltInParser; meriyah: BuiltInParser; mjml: BuiltInParser; scss: BuiltInParser; typescript: BuiltInParser; vue: BuiltInParser; yaml: BuiltInParser; }
`prettier · getSupportInfo`	`(): SupportInfo`	`(options?: SupportInfoOptions \| undefined): Promise<SupportInfo>`
`prettier · clearConfigCache`	`(): void`	`(): Promise<void>`
`prettier · formatWithCursor`	`(source: string, options: CursorOptions): CursorResult`	`(source: string, options: CursorOptions): Promise<CursorResult>`
`prettier · BuiltInParserName`	`"angular" \| "babel-flow" \| "babel-ts" \| "babel" \| "css" \| "espree" \| "flow" \| "glimmer" \| "graphql" \| "html" \| "json-stringify" \| "json" \| "json5" \| "less" \| "lwc" \| "markdown" \| "mdx" \| "meriyah" \| "scss" \| "typescript" \| "vue" \| "yaml"`	`"acorn" \| "angular" \| "babel-flow" \| "babel-ts" \| "babel" \| "css" \| "espree" \| "flow" \| "glimmer" \| "graphql" \| "html" \| "json-stringify" \| "json" \| "json5" \| "jsonc" \| "less" \| "lwc" \| "markdown" \| "mdx" \| "meriyah" \| "mjml" \| "scss" \| "typescript" \| "vue" \| "yaml"`
`prettier · resolveConfigFile`	`(filePath?: string \| undefined): Promise<string \| null>`	`(fileUrlOrPath?: string \| URL \| undefined): Promise<string \| null>`
`prettier/standalone · check`	`(source: string, options?: Options \| undefined): boolean`	`(source: string, options?: Options \| undefined): Promise<boolean>`
`prettier/standalone · format`	`(source: string, options?: Options \| undefined): string`	`(source: string, options?: Options \| undefined): Promise<string>`
`prettier/standalone · getSupportInfo`	`(): SupportInfo`	`(): Promise<SupportInfo>`
`prettier/standalone · formatWithCursor`	`(source: string, options: CursorOptions): CursorResult`	`(source: string, options: CursorOptions): Promise<CursorResult>`

削除されたクラス／インターフェースのメンバー

member	import	変更前
`Config.pluginSearchDirs`	`prettier`	`false \| string[] \| undefined`
`Options.pluginSearchDirs`	`prettier`	`false \| string[] \| undefined`
`CursorOptions.pluginSearchDirs`	`prettier`	`false \| string[] \| undefined`
`ParserOptions.pluginSearchDirs`	`prettier`	`false \| string[]`
`RequiredOptions.pluginSearchDirs`	`prettier`	`false \| string[]`
`SupportLanguage.since`	`prettier`	`string \| undefined`
`IntSupportOption.since`	`prettier`	`string`
`BaseSupportOption.since`	`prettier`	`string`
`PathSupportOption.since`	`prettier`	`string`
`ChoiceSupportOption.since`	`prettier`	`string`
`StringSupportOption.since`	`prettier`	`string`
`BooleanSupportOption.since`	`prettier`	`string`
`IntArraySupportOption.since`	`prettier`	`string`
`PathArraySupportOption.since`	`prettier`	`string`
`StringArraySupportOption.since`	`prettier`	`string`
`BooleanArraySupportOption.since`	`prettier`	`string`

変更されたクラス／インターフェースのメンバー

member	変更前	変更後
`Config.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string> \| undefined`	`LiteralUnion<BuiltInParserName, string> \| undefined`
`Config.plugins`	`(string \| Plugin<any>)[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`Config.proseWrap`	`"always" \| "never" \| "preserve" \| undefined`	`"preserve" \| "always" \| "never" \| undefined`
`Parser.parse`	`(text: string, parsers: { [parserName: string]: Parser<any>; }, options: ParserOptions<T>): T`	`(text: string, options: ParserOptions<T>): T \| Promise<T>`
`Parser.preprocess`	`((text: string, options: ParserOptions<T>) => string) \| undefined`	`((text: string, options: ParserOptions<T>) => string \| Promise<string>) \| undefined`
`Options.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string> \| undefined`	`LiteralUnion<BuiltInParserName, string> \| undefined`
`Options.plugins`	`(string \| Plugin<any>)[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`Options.proseWrap`	`"always" \| "never" \| "preserve" \| undefined`	`"preserve" \| "always" \| "never" \| undefined`
`Printer.embed`	`((path: AstPath<T>, print: (path: AstPath<T>) => Doc, textToDoc: (text: string, options: Options) => Doc, options: ParserOptions<T>) => Doc \| null) \| undefined`	`((path: AstPath<any>, options: Options) => Doc \| ((textToDoc: (text: string, options: Options) => Promise<Doc>, print: (selector?: string \| number \| (string \| number)[] \| AstPath<any> \| undefined, args?: unknown) => Doc, path: AstPath<any>, options: Options) => Doc \| Promise<Doc \| undefined> \| undef…`
`Printer.print`	`(path: AstPath<T>, options: ParserOptions<T>, print: (path: AstPath<T>) => Doc, args?: unknown): Doc`	`(path: AstPath<T>, options: ParserOptions<T>, print: (selector?: string \| number \| AstPath<T> \| (string \| number)[] \| undefined, args?: unknown) => Doc, args?: unknown): Doc`
`Printer.preprocess`	`((ast: any, options: ParserOptions<T>) => any) \| undefined`	`((ast: T, options: ParserOptions<T>) => T \| Promise<T>) \| undefined`
`Printer.massageAstNode`	`((node: any, newNode: any, parent: any) => any) \| undefined`	`((original: any, cloned: any, parent: any) => any) \| undefined`
`Printer.canAttachComment`	`((node: T) => boolean) \| undefined`	`((node: T, ancestors: T[]) => boolean) \| undefined`
`CursorOptions.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string> \| undefined`	`LiteralUnion<BuiltInParserName, string> \| undefined`
`CursorOptions.plugins`	`(string \| Plugin<any>)[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`CursorOptions.rangeEnd`	`undefined`	`number \| undefined`
`CursorOptions.proseWrap`	`"always" \| "never" \| "preserve" \| undefined`	`"preserve" \| "always" \| "never" \| undefined`
`CursorOptions.rangeStart`	`undefined`	`number \| undefined`
`ParserOptions.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string>`	`LiteralUnion<BuiltInParserName, string>`
`ParserOptions.plugins`	`(string \| Plugin<any>)[]`	`(string \| URL \| Plugin<any>)[]`
`ParserOptions.useTabs`	`boolean`	`boolean \| undefined`
`ParserOptions.proseWrap`	`"always" \| "never" \| "preserve"`	`"preserve" \| "always" \| "never"`
`ParserOptions.jsxBracketSameLine`	`boolean`	`boolean \| undefined`
`FileInfoOptions.plugins`	`string[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`FileInfoOptions.ignorePath`	`string \| undefined`	`string \| URL \| (string \| URL)[] \| undefined`
`RequiredOptions.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string>`	`LiteralUnion<BuiltInParserName, string>`
`RequiredOptions.plugins`	`(string \| Plugin<any>)[]`	`(string \| URL \| Plugin<any>)[]`
`RequiredOptions.useTabs`	`boolean`	`boolean \| undefined`
`RequiredOptions.proseWrap`	`"always" \| "never" \| "preserve"`	`"preserve" \| "always" \| "never"`
`RequiredOptions.jsxBracketSameLine`	`boolean`	`boolean \| undefined`
`ChoiceSupportOption.choices`	`{ since?: string \| undefined; value: Value; description: string; }[]`	`{ value: Value; description: string; }[]`
`ChoiceSupportOption.default`	`Value \| { since: string; value: Value; }[] \| undefined`	`Value \| { value: Value; }[] \| undefined`
`ResolveConfigOptions.config`	`string \| undefined`	`string \| URL \| undefined`

新たに非推奨

export	@deprecated
`prettier · AstPath.getName`	Please use `AstPath#key` or `AstPath#index`
`prettier · AstPath.getValue`	Please use `AstPath#node` or `AstPath#siblings`

要件の変更（engines、peer 依存関係）

	変更前	変更後
`engines.node`	`>=10.13.0`	`>=14`

新しいエクスポート (1)

import	export	kind
`prettier`	`SupportInfoOptions`	interface

よくある質問

prettier を 2 から 3 にアップグレードする際の破壊的変更は？

prettier 2.8.8 と 3.9.9 の間で、Vigia は削除されたエクスポートを 2 件、変更されたシグネチャを 14 件、削除または変更されたクラス／インターフェースのメンバーを 49 件検出しました。

prettier 3 で非推奨になったものは？

prettier 3.9.9 では 2 件のエクスポートまたはメンバーが新たに非推奨になりました。

エージェント向け

GET https://vigia.coredls.cloud/v1/packages/npm/prettier/upgrade?from=2.8.8&to=3.9.9

member	変更前	変更後
`Config.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string> \| undefined`	`LiteralUnion<BuiltInParserName, string> \| undefined`
`Config.plugins`	`(string \| Plugin<any>)[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`Config.proseWrap`	`"always" \| "never" \| "preserve" \| undefined`	`"preserve" \| "always" \| "never" \| undefined`
`Parser.parse`	`(text: string, parsers: { [parserName: string]: Parser<any>; }, options: ParserOptions<T>): T`	`(text: string, options: ParserOptions<T>): T \| Promise<T>`
`Parser.preprocess`	`((text: string, options: ParserOptions<T>) => string) \| undefined`	`((text: string, options: ParserOptions<T>) => string \| Promise<string>) \| undefined`
`Options.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string> \| undefined`	`LiteralUnion<BuiltInParserName, string> \| undefined`
`Options.plugins`	`(string \| Plugin<any>)[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`Options.proseWrap`	`"always" \| "never" \| "preserve" \| undefined`	`"preserve" \| "always" \| "never" \| undefined`
`Printer.embed`	`((path: AstPath<T>, print: (path: AstPath<T>) => Doc, textToDoc: (text: string, options: Options) => Doc, options: ParserOptions<T>) => Doc \| null) \| undefined`	`((path: AstPath<any>, options: Options) => Doc \| ((textToDoc: (text: string, options: Options) => Promise<Doc>, print: (selector?: string \| number \| (string \| number)[] \| AstPath<any> \| undefined, args?: unknown) => Doc, path: AstPath<any>, options: Options) => Doc \| Promise<Doc \| undefined> \| undef…`
`Printer.print`	`(path: AstPath<T>, options: ParserOptions<T>, print: (path: AstPath<T>) => Doc, args?: unknown): Doc`	`(path: AstPath<T>, options: ParserOptions<T>, print: (selector?: string \| number \| AstPath<T> \| (string \| number)[] \| undefined, args?: unknown) => Doc, args?: unknown): Doc`
`Printer.preprocess`	`((ast: any, options: ParserOptions<T>) => any) \| undefined`	`((ast: T, options: ParserOptions<T>) => T \| Promise<T>) \| undefined`
`Printer.massageAstNode`	`((node: any, newNode: any, parent: any) => any) \| undefined`	`((original: any, cloned: any, parent: any) => any) \| undefined`
`Printer.canAttachComment`	`((node: T) => boolean) \| undefined`	`((node: T, ancestors: T[]) => boolean) \| undefined`
`CursorOptions.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string> \| undefined`	`LiteralUnion<BuiltInParserName, string> \| undefined`
`CursorOptions.plugins`	`(string \| Plugin<any>)[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`CursorOptions.rangeEnd`	`undefined`	`number \| undefined`
`CursorOptions.proseWrap`	`"always" \| "never" \| "preserve" \| undefined`	`"preserve" \| "always" \| "never" \| undefined`
`CursorOptions.rangeStart`	`undefined`	`number \| undefined`
`ParserOptions.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string>`	`LiteralUnion<BuiltInParserName, string>`
`ParserOptions.plugins`	`(string \| Plugin<any>)[]`	`(string \| URL \| Plugin<any>)[]`
`ParserOptions.useTabs`	`boolean`	`boolean \| undefined`
`ParserOptions.proseWrap`	`"always" \| "never" \| "preserve"`	`"preserve" \| "always" \| "never"`
`ParserOptions.jsxBracketSameLine`	`boolean`	`boolean \| undefined`
`FileInfoOptions.plugins`	`string[] \| undefined`	`(string \| URL \| Plugin<any>)[] \| undefined`
`FileInfoOptions.ignorePath`	`string \| undefined`	`string \| URL \| (string \| URL)[] \| undefined`
`RequiredOptions.parser`	`CustomParser \| LiteralUnion<BuiltInParserName, string>`	`LiteralUnion<BuiltInParserName, string>`
`RequiredOptions.plugins`	`(string \| Plugin<any>)[]`	`(string \| URL \| Plugin<any>)[]`
`RequiredOptions.useTabs`	`boolean`	`boolean \| undefined`
`RequiredOptions.proseWrap`	`"always" \| "never" \| "preserve"`	`"preserve" \| "always" \| "never"`
`RequiredOptions.jsxBracketSameLine`	`boolean`	`boolean \| undefined`
`ChoiceSupportOption.choices`	`{ since?: string \| undefined; value: Value; description: string; }[]`	`{ value: Value; description: string; }[]`
`ChoiceSupportOption.default`	`Value \| { since: string; value: Value; }[] \| undefined`	`Value \| { value: Value; }[] \| undefined`
`ResolveConfigOptions.config`	`string \| undefined`	`string \| URL \| undefined`