ترقية prettier من 2.x إلى 3.x

مقارنة الواجهة العامة لـ prettier بين 2.8.8 و3.9.9، محسوبة تلقائيًا من أنواع 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؟

عُلِّم 2 من الصادرات أو الأعضاء حديثًا على أنها موقوفة في prettier 3.9.9.

للوكلاء

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`