Cambios importantes y obsolescencias

Esta página enumera todos los cambios importantes y obsolescencias en las actualizaciones del SDK de Dart, organizados por versión y área, para ayudar a los desarrolladores de Dart a comprender y gestionar su impacto. Las notas completas de la versión están disponibles en el changelog del SDK de Dart. El documento de la política de cambios importantes describe la política y el proceso en torno a los cambios importantes y las obsolescencias en Dart.

Esta página incluye los siguientes tipos de cambios importantes:

No versionados

El SDK de Dart no mantiene la compatibilidad hacia atrás, y el código podría romperse tan pronto como actualices la versión de tu SDK si depende del comportamiento anterior.

Estos representan la mayoría de los cambios y no están marcados especialmente en esta lista.

Versionados por lenguaje

El SDK de Dart mantiene la compatibilidad hacia atrás para el código existente, y el cambio de comportamiento solo surte efecto (rompiendo potencialmente el código que depende del comportamiento anterior) cuando actualizas la versión de lenguaje de tu código.

These are marked as: Con versión de lenguaje

Obsolescencias

El SDK de Dart mantiene la compatibilidad para el código obsoleto, con una advertencia. Las obsolescencias se eliminan por completo en una versión posterior, rompiendo cualquier código que dependa del comportamiento anterior.

These are marked as: Obsoleto / Eliminado

Experimental

Parte de la versión pero aún no tratado como estable en el SDK y puede romperse de una versión a otra. Los cambios experimentales no siempre tienen un problema de cambio importante correspondiente, pero podrían tener más detalles en el changelog del SDK.

Estos están marcados: Experimental

Si tienes preguntas o inquietudes sobre cualquiera de estos cambios importantes, por favor comenta en el hilo del cambio importante enlazado desde la entrada correspondiente. Para recibir notificaciones sobre futuros cambios importantes, únete al grupo Dart announce.

• NetworkInterface.addresses ahora devuelve List<InterfaceAddress> en lugar de List<InternetAddress>. El nuevo subtipo InterfaceAddress de InternetAddress expone un campo prefixLength y un getter broadcast. El código que implementa NetworkInterface y sobrescribe addresses debe actualizar el tipo de retorno.

• JSFunction y JSExportedDartFunction ahora son genéricos. JSExportedDartFunction<T>.toDart ahora convierte (cast) la función envuelta original al argumento de tipo T, e isA<JSExportedDartFunction<T>> ahora también comprueba que la función envuelta es de tipo T. Los tipos en tiempo de ejecución de JSFunction y JSExportedDartFunction no cambian.

• Se dejó de añadir una línea en blanco antes de un comentario al final de una unidad de compilación o de un cuerpo entre llaves.

• Las cláusulas de representación de tipo de extensión (extension type) ahora se formatean de la misma manera que las listas de parámetros formales del constructor primario.

• Cuando se conservan las comas finales, ya no se inserta una nueva línea antes del ; en un enum con miembros a menos que haya una coma final.

• Se corrigió un error por el cual algunas colecciones o argumentos podían dividirse innecesariamente.

• Versionados por lenguaje Las listas de parámetros ahora pueden formatearse en bloque.

• Versionados por lenguaje Las expresiones as, is e is! ahora pueden formatearse en bloque.

• Versionados por lenguaje Se añaden líneas en blanco alrededor de las declaraciones de mixin y de extension type si no tienen un cuerpo con ;.

• Eliminado Ya no se incluyen los certificados raíz de respaldo incorporados que se utilizaban cuando no se encontraban los certificados del sistema. Si no se encuentran los certificados del sistema, utiliza las opciones --root-certs-file o --root-certs-cache para proporcionar certificados de respaldo a la Dart VM independiente.

• El método de extensión isA se ha movido de JSAnyUtilityExtension a NullableObjectUtilExtension para admitir la comprobación de tipos de cualquier Object?. Este cambio solo es importante si te referías al nombre de la extensión directamente, ya sea aplicando la extensión directamente o mediante las directivas show o hide.
• isA<JSObject>() ahora maneja correctamente los objetos JS sin prototipos, e isA<JSAny>() realiza una comprobación no trivial de que el valor es un valor JS.
• isA<JSExportedDartFunction>() ahora comprueba si la función es realmente una función envoltura de JS que se devuelve desde Function.toJS o Function.toJSCaptureThis.

• dart pub cache repair ahora solo repara los paquetes referenciados por el archivo pubspec.lock del proyecto actual de forma predeterminada. Para reparar todos los paquetes en la caché de pub como en versiones anteriores, pasa la nueva bandera --all.

• La API del cargador de módulos de carga diferida (deferred loading) se ha actualizado para permitir la obtención por lotes de módulos diferidos. El embebedor ahora toma loadDeferredModules en lugar de loadDeferredModule, where la nueva función debe esperar una matriz (array) de nombres de módulos en lugar de nombres de módulos individuales. Todas las funciones de carga de módulos ahora también deben aceptar un callback instantiator al que deben pasar los resultados cargados.

• JSExportedDartFunction.toDart ahora lanza una excepción si la función JS envoltura (wrapper) no fue resultado de Function.toJS o Function.toJSCaptureThis, para ser consistente con DDC y dart2wasm. Anteriormente, a veces devolvía incorrectamente la función Dart original incluso si la función JS envoltura se convertía (cast) desde una llamada a la función obsoleta allowInterop.

• Obsoleto La regla de linter avoid_null_checks_in_equality_operators está obsoleta y debe eliminarse de los archivos analysis_options.yaml.

• Obsoleto La regla de linter prefer_final_parameters está obsoleta y debe eliminarse de los archivos analysis_options.yaml.

• Obsoleto La regla de linter use_if_null_to_convert_nulls_to_bools está obsoleta y debe eliminarse de los archivos analysis_options.yaml.

• Eliminado El código que importa dart:js_util o package:js ahora da como resultado un error de compilación al compilar a WebAssembly.

  La invocación de cualquier API de estas bibliotecas dará como resultado un error en tiempo de ejecución. Los usos deben migrarse a dart:js_interop y dart:js_interop_unsafe.

• Las funciones generadoras sync* y async* sin un retorno especificado ahora infieren correctamente los tipos de retorno como no nulables cuando no se produce ningún valor null. Esto podría activar nuevos diagnósticos relacionados con elementos de código innecesarios, como un operador de acceso condicional de nulos innecesario (?.).

• Las funciones Uri.parseIPv4Address y Uri.parseIPv6Address ya no permiten incorrectamente ceros a la izquierda en las direcciones IPv4.

• Obsoleto La capacidad de implementar RegExp y RegExpMatch está obsoleta y se eliminará en una versión futura.

• IOOverrides ya no se puede implementar, pero aún se puede extender.

• La extensión Uint16ListToJSInt16Array ha sido renombrada a Uint16ListToJSUint16Array.

• La extensión JSUint16ArrayToInt16List ha sido renombrada a JSUint16ArrayToUint16List.

• La función Function.toJSCaptureThis ahora produce comprobaciones adicionales en tiempo de compilación para coincidir con Function.toJS. Si la función no tiene un tipo estáticamente conocido, tiene tipos no admitidos en su firma, incluye parámetros de tipo, o tiene algún parámetro con nombre, la llamada dará como resultado un error en tiempo de compilación.

• La CLI de dart y la Dart VM son ahora ejecutables separados, llamándose dartvm al ejecutable y proceso de la Dart VM pura. Los programas de Dart aún deben ejecutarse con dart run.

• Los subcomandos de la herramienta dart, como dart format y dart compile ahora ejecutan snapshots compilados con AOT de las herramientas subyacentes. No debería haber diferencias funcionales aparte de las mejoras de rendimiento, pero si encuentras incompatibilidades, por favor infórmalas.

• Eliminado La herramienta dart ya no está disponible para plataformas IA32, ya que el SDK de Dart ya no es compatible con IA32.

• El uso de miembros marcados como @experimental fuera del paquete en el que están declarados ahora genera una advertencia.

• Las reglas de linter habilitadas en los archivos de opciones de análisis incluidos ahora producen diagnósticos de linter incompatibles cuando corresponde.

• Eliminado La anotación obsoleta @required de package:meta ya no es compatible. Para marcar un parámetro como requerido, utiliza en su lugar la palabra clave required.

• dart:js_util y package:js ya no son compatibles al compilar a WebAssembly. La invocación de cualquier API de estas bibliotecas dará como resultado un error en tiempo de ejecución. Los usos deben migrarse a dart:js_interop y dart:js_interop_unsafe.

• Para coincidir con los compiladores de JS, dartify, al compilarse a Wasm, ahora convierte los objetos JS Promise en objetos Dart Future en lugar de objetos Dart JSValue.

• Versionados por lenguaje Ahora se asume Null Safety al calcular la promoción de tipos, la alcanzabilidad y la asignación definitiva. Como resultado, un análisis de código muerto mejorado podría hacer que se activen nuevos diagnósticos del analyzer en el código existente que antes superaba el análisis.

• Algunos subcomandos de la herramienta dart, como dart analyze y dart fix ahora ejecutan snapshots compilados con AOT de las herramientas subyacentes. No debería haber diferencias funcionales aparte de las mejoras de rendimiento, pero si encuentras incompatibilidades, por favor infórmalas.

• Versionados por lenguaje Ahora se respeta el límite superior de la restricción del SDK de flutter en el paquete raíz de tu espacio de trabajo. Si tu SDK actual no cumple con el límite especificado, dart pub get y otras acciones que recuperan dependencias fallarán.

• Experimental Compilar un paquete de aplicación de CLI con soporte experimental para recursos nativos ahora requiere usar el subcomando dart build cli y especificar el punto de entrada de la aplicación con una nueva opción --target.

• Eliminado El constructor Element.created ha sido eliminado.
• Las clases nativas en dart:html, como HtmlElement, ya no se pueden extender.

• Obsoleto La regla de linter avoid_null_checks_in_equality_operators está obsoleta y debe eliminarse de los archivos analysis_options.yaml.

• Ahora lanza un error en tiempo de ejecución cuando se realiza un tear-off de un constructor de fábrica de redirección y no se proporciona ningún valor a uno de sus parámetros opcionales no nulables. En el futuro, es probable que esto sea un error en tiempo de compilación.

• Experimental Eliminado Las banderas --experiment-new-rti y --use-old-rti ya no son compatibles.

• Versionados por lenguaje El formateador realizó cambios y correcciones que producen un nuevo resultado al formatear código con una versión de lenguaje de 3.8 o superior.

• Versionados por lenguaje Las variables locales y los parámetros nombrados _ ahora no son vinculantes y ya no se pueden usar ni acceder.
• El análisis de alcanzabilidad ahora tiene en cuenta si un campo se promueve de tipo a Null usando is o as. Esto hace que el sistema de tipos sea más autoconsistente, porque refleja el comportamiento de las variables locales promovidas. No se espera que este cambio marque ninguna diferencia en la práctica.

• Obsoleto Estas bibliotecas web heredadas están oficialmente obsoletas. Se espera que se eliminen en una versión futura. Los proyectos deben migrar para usar package:web y dart:js_interop. Para obtener más información, consulta Migrar a package:web.

• Obsoleto Estas bibliotecas heredadas de interoperabilidad JS están oficialmente obsoletas. Se espera que se eliminen en una versión futura. Los proyectos deben migrar para usar dart:js_interop. Para obtener más información, consulta Uso de interoperabilidad JS.

• Eliminado Las reglas de linter package_api_docs y unsafe_html se han eliminado y deben eliminarse de los archivos analysis_options.yaml.

• Versionados por lenguaje El formateador implementa un nuevo estilo que produce un nuevo resultado al formatear código con una versión de lenguaje de 3.7 o superior.
• Eliminado La bandera --fix para dart format ya no es compatible. Para aplicar correcciones similares y más, configura tus opciones de análisis y ejecuta dart fix.
• Obsoleto La opción --line-length para dart format se ha declarado obsoleta y está programada para eliminarse. Todos los usos deben migrarse a la nueva opción --page-width.

• El contexto utilizado por Dart para realizar la inferencia de tipos en el operando de una expresión throw ha cambiado del "tipo desconocido" a Object. Esto hace que el sistema de tipos sea más autoconsistente, porque refleja el hecho de que no es legal lanzar null. No se espera que este cambio marque ninguna diferencia en la práctica.

• Eliminado El constructor Platform() ha sido eliminado. Todas las instanciaciones de Platform deberían eliminarse.
• HttpClient ahora responde a una redirección a la que le falta una cabecera "Location" lanzando una RedirectException en lugar de un StateError.

• Obsoleto Las reglas de linter package_api_docs y unsafe_html se han declarado obsoletas y están programadas para eliminarse en Dart 3.7.

• El compilador de Dart ahora calcula las clausuras superior e inferior de los esquemas de tipo justo antes de que se pasen al procedimiento de prueba de subtipos. Antes de Dart 3.6, el compilador los calculaba al principio de los cálculos de límite superior e inferior. El analyzer ya seguía este comportamiento, por lo que es poco probable que las aplicaciones que ya pasan el análisis se vean afectadas por este cambio.

• La condición dart.library.js ahora es false en las importaciones condicionales cuando se compila a WebAssembly. En su lugar, se debe utilizar la condición dart.library.js_interop.

Los siguientes cambios podrían producir pequeños cambios de formato al ejecutar dart format con un SDK de Dart 3.6 o posterior:

• Conservar los parámetros de tipo en los parámetros formales con tipo de función de estilo antiguo que también usan this. o super..
• Formatear correctamente importaciones con cláusulas as y if.

• dart pub publish ahora advierte si los archivos que están siendo rastreados en git tienen cambios sin confirmar (uncommitted).

• El contexto utilizado por el compilador para realizar la inferencia de tipos en el operando de una expresión await ha cambiado para coincidir con el comportamiento del analyzer.
• El contexto utilizado por el compilador para realizar la inferencia de tipos en el lado derecho de una expresión "if-null" (e1 ?? e2) ha cambiado para coincidir con el comportamiento del analyzer. El comportamiento anterior se puede restaurar proporcionando tipos explícitos.

• DateTime ahora almacena microsegundos en la plataforma web, coincidiendo más estrechamente con el comportamiento en las plataformas nativas.

• SecurityContext ahora es final y ya no se puede heredar..

• importModule ahora acepta un JSAny en lugar de un String para admitir también otros valores JS, como los objetos TrustedScriptURL.
• isTruthy y not ahora devuelven JSBoolean en lugar de bool para ser consistentes con otros métodos de operadores de JS.
• ExternalDartReference ya no implementa Object. En su lugar, ahora acepta un parámetro de tipo (T) con un límite (bound) de Object? para capturar el tipo del objeto Dart que se externaliza.

• Eliminado Las clases de vista no modificables para datos tipados han sido eliminadas. En lugar de utilizar los constructores de estas clases, utiliza los nuevos métodos asUnmodifiableView en las listas de datos tipados.

• Eliminado The Dart VM no longer supports unsound null safety.
  • La opción CLI --no-sound-null-safety ha sido eliminada.
  • Las funciones Dart_NewListOf y Dart_IsLegacyType han sido eliminadas de la API de C.
• Eliminado La función Dart_DefaultCanonicalizeUrl ha sido eliminada de la API de C.

• El esquema de tipo de contexto de patrón para los patrones de cast ahora es _ (el tipo desconocido) en lugar de Object?.
• El esquema de tipos utilizado por los compiladores de Dart para realizar la inferencia de tipos en el operando de un operador de propagación condicional de nulos (...?) en literales de mapas y conjuntos se ha hecho nulable, para coincidir con lo que sucede actualmente en los literales de lista.

• Experimental Eliminado La función waitFor ha sido eliminada.

• Obsoleto Estas bibliotecas ahora están marcadas como heredadas y tendrán menos soporte en el futuro. Los proyectos nuevos deberían preferir usar package:web y dart:js_interop. Para obtener más información, consulta Migrar a package:web.

• Obsoleto Esta biblioteca ahora está marcada como heredada y tendrá menos soporte en el futuro. Los usos deben migrarse a dart:js_interop y dart:js_interop_unsafe. Para obtener más información, consulta /go/next-gen-js-interop.

• Obsoleto Esta biblioteca ahora está marcada como heredada y tendrá menos soporte en el futuro. Los usos deben migrarse a dart:js_interop y dart:js_interop_unsafe. Para obtener más información, consulta /go/next-gen-js-interop.

• Stdout tiene un nuevo campo lineTerminator, que permite a los desarrolladores controlar el final de línea utilizado por stdout y stderr. Las clases que implementan Stdout deben definir el campo lineTerminator. La semántica predeterminada de stdout y stderr no ha cambiado.
• Obsoleto La propiedad FileSystemDeleteEvent.isDirectory. Siempre devuelve false.

• Obsoleto Las clases de vista no modificables para datos tipados están obsoletas. En lugar de utilizar los constructores de estas clases, utiliza los nuevos métodos asUnmodifiableView en las listas de datos tipados.

• Experimental Obsoleto Ahora debes especificar un formato para la opción de CLI --dump-info, ya sea binary o json. El formato json está obsoleto y podría eliminarse en una futura versión de Dart.

• Experimental Varios argumentos de CLI de dart compile wasm han sido actualizados, eliminados o reemplazados. Para obtener más información, ejecuta dart compile wasm --verbose --help.

• Eliminado La Dart VM ya no admite cadenas externas. Como resultado, las funciones Dart_IsExternalString, Dart_NewExternalLatin1String y Dart_NewExternalUTF16String han sido eliminadas de la API de C de Dart.

• Experimental Eliminado Los siguientes experimentos ahora están retirados ya que fueron lanzados en Dart 3 y ya no son necesarios con una versión de lenguaje de 3.0 o superior. Su configuración debe ser eliminada de las opciones de análisis, comandos de CLI y configuraciones del IDE.

  • patterns
  • records
  • class-modifiers
  • sealed-class

• Un getter abstracto ahora se considera promotable si no hay declaraciones conflictivas.

• Experimental Obsoleto La función waitFor sigue estando obsoleta por otra versión más y está programada para su eliminación en Dart 3.4.

• Obsoleto Los métodos de aritmética de punteros elementAt en los tipos Pointer están obsoletos. Migra en su lugar a los operadores - y +.
• Experimental Eliminado La anotación @FfiNative previamente declarada obsoleta ha sido eliminada. Los usos deben actualizarse para usar la anotación @Native.

• En lugar de utilizar HttpRequest directamente, ahora se recomienda utilizar package:http.

• En lugar de utilizar HttpClient directamente, ahora se recomienda utilizar package:http.

• Experimental Los tipos JS como JSAny tienen nuevos tipos de representación específicos del compilador.
• Experimental Las clases @staticInterop definidas por el usuario ya no pueden implementar JSAny o JSObject. Los usos deben migrarse a JSObject.fromInteropObject o definirse como tipos de extensión (extension types).
• Experimental JSArray y JSPromise ahora tienen parámetros genéricos.
• Experimental Varios miembros de extensión fueron movidos o renombrados. Para conocer las extensiones actualizadas, consulta JSAnyUtilityExtension y JSAnyOperatorExtension.

• Las clases de vista no modificables para datos tipados se declararán obsoletas en Dart 3.4. En lugar de utilizar los constructores de estas clases, utiliza los nuevos métodos asUnmodifiableView en las listas de datos tipados.

• Experimental Todas las clases de envoltura nativas ahora están marcadas como base para que ninguno de sus subtipos pueda ser implementado.

• La Invocation que se pasa a noSuchMethod ya no tiene un memberName minificado, incluso cuando se compila con --minify.

• Experimental No permitir importar bibliotecas heredadas de interoperabilidad JS. En su lugar, prefiere usar dart:js_interop y dart:js_interop_unsafe.

• Experimental Las directivas de comentarios de dart doc que no sean válidas ahora son reportadas por el analyzer.

• Debido a las mejoras en la promoción de tipos, los siguientes diagnósticos del analyzer podrían activarse en el código existente que antes superaba el análisis:

  • unnecessary_non_null_assertion
  • unnecessary_cast
  • invalid_null_aware_operator

• Se eliminaron las reglas de linter iterable_contains_unrelated_type y list_remove_unrelated_type. Considera migrar a la regla expandida collection_methods_unrelated_type.

• Las siguientes reglas de linter se eliminan porque ya no son necesarias con sound null safety. Debes eliminar su configuración de tus archivos analysis_options.yaml y cualquier comentario de ignore.

  • always_require_non_null_named_parameters
  • avoid_returning_null
  • avoid_returning_null_for_future

• Versionados por lenguaje Se cambió el punto de división para los patrones refutables al patrón de nivel superior para que la promoción de tipos en las declaraciones if-case sea consistente independientemente de si el valor examinado (scrutinee) podría lanzar una excepción.

• Experimental Obsoleto La función waitFor.

• Se cambiaron los tipos de retorno de utf8.encode() y Utf8Codec.encode() de List<int> a Uint8List.

• Obsoleto El método Service.getIsolateID.

• Se cambió NativeCallable.nativeFunction para que las llamadas ahora lancen un error si el receptor ya está cerrado, en lugar de devolver nullptr.

• Se eliminaron los espacios en blanco al final de las cabeceras HTTP.
• Se insertó un espacio en el punto de plegado de los valores de cabecera plegados que devuelven HttpClientResponse.headers y HttpRequest.headers.

• Experimental Eliminado JSNumber.toDart a favor de toDartDouble y toDartInt.
• Experimental Eliminado Object.toJS a favor de Object.toJSBox.
• Experimental Se restringieron las API externas de interoperabilidad JS usando dart:js_interop a un conjunto de tipos permitidos.
• Experimental Se prohibió el uso de isNull e isUndefined en dart2wasm.
• Experimental Se cambiaron las API typeofEquals e instanceof para que ambas devuelvan bool en lugar de JSBoolean. Además, typeofEquals ahora toma String en lugar de JSString.
• Experimental Se cambiaron los tipos JSAny y JSObject para que solo sean implementables, no heredables, por los tipos @staticInterop del usuario.
• Experimental Se cambió JSArray.withLength para que tome int en lugar de JSNumber.

• Se agregaron interceptores para los tipos Symbol y BigInt de JavaScript; ya no deberían usarse con clases de package:js.

• Se agregaron interceptores para los tipos Symbol y BigInt de JavaScript; ya no deberían usarse con clases de package:js.

• Versionados por lenguaje La promoción de campos privados finales podría hacer que se activen las siguientes advertencias del analyzer en el código existente que antes superaba el análisis:

  • unnecessary_non_null_assertion
  • invalid_null_aware_operator
  • unnecessary_cast
  dart

  class C {
    final num? _x = null;
  ​
    void test() {
      if (_x != null) {
        print(_x! * 2); // unnecessary_non_null_assertion
        print(_x?.abs()); // invalid_null_aware_operator
      }
      if (_x is int) {
        print((_x as int).bitLength); // unnecessary_cast
      }
    }
  }
  

  content_copy

• Se añadió el modificador interface a clases puramente abstractas: MultiStreamController, StreamConsumer, StreamIterator y StreamTransformer.

• Se añadió sameSite a la clase Cookie, y se añadió la clase SameSite.
• FileSystemEvent está sellada (sealed). Esto significa que FileSystemEvent no se puede extender ni implementar.

• Experimental Eliminado ObjectLiteral; crea un literal de objeto sin miembros con nombre usando {}.jsify().

• Los miembros external @staticInterop y los miembros de extensión external ya no se pueden usar como tear-offs. Declara una clausura (closure) o un método que no sea external que llame a estos miembros, y usa eso en su lugar.
• Los miembros external @staticInterop y los miembros de extensión external generarán un código JS ligeramente diferente para los métodos que tienen parámetros opcionales.

• Versionados por lenguaje Se cambió la interpretación de los casos de switch (switch cases) de expresiones constantes a patrones.

• Versionados por lenguaje Las declaraciones de clase de bibliotecas que se han actualizado a Dart 3.0 ya no se pueden utilizar como mixins de forma predeterminada.

• Dart informa un error en tiempo de compilación si una instrucción continue apunta a una etiqueta (label) que no es un bucle (instrucciones for, do y while) o un miembro de un switch.

• Las siguientes clases existentes se han convertido en clases mixin: Iterable, IterableMixin, IterableBase, ListMixin, SetMixin, MapMixin, LinkedListEntry, StringConversionSink.

• Obsoleto APIs obsoletas.

• Eliminado Se eliminó la clase obsoleta DeferredLibrary.

• Con versión de lenguaje Cambios en las bibliotecas de la plataforma.

• Eliminado Se eliminó la constante obsoleta MAX_USER_TAGS. Utiliza maxUserTags en su lugar.
• Eliminado Se eliminaron las clases obsoletas Metrics, Metric, Counter, y Gauge ya que no funcionaban desde Dart 2.0.

• Experimental Obsoleto La anotación @FfiNative ahora está obsoleta. Los usos deben actualizarse para usar la anotación @Native.

• Eliminado Se eliminaron los métodos obsoletos registerElement y registerElement2 en Document y HtmlDocument.

• Versionados por lenguaje La interfaz Random solo se puede implementar, no extender.

• Se actualizó NetworkProfiling para acomodar los nuevos String ids que se introducen en vm_service:11.0.0

• Se marcó código adicional como inalcanzable debido a los tipos Null y Never.
• No delegar nombres privados inaccesibles a noSuchMethod.
• Informar un error en tiempo de compilación para todas las dependencias cíclicas durante la inferencia de tipos de nivel superior.

• Eliminado La API anteriormente declarada obsoleta [DEFAULT_BUFFER_SIZE] en JsonUtf8Encoder ha sido eliminada.

• Eliminado Se eliminaron las API anteriormente declaradas obsoletas kInvalidParams, kExtensionError, kExtensionErrorMax, y kExtensionErrorMin en ServiceExtensionResponse.

• Se cambió el argumento de tipo en tiempo de ejecución de Pointer a Never en preparación para eliminar por completo el argumento de tipo en tiempo de ejecución. Se cambió Pointer.toString para que no informe ningún argumento de tipo.

• No permitir cabeceras content-length negativas o hexadecimales.
• File.create ahora toma un nuevo parámetro opcional exclusive de tipo bool, y cuando es true la operación fallará si el archivo de destino ya existe.
• Llamar a ResourceHandle.toFile(), ResourceHandle.toSocket(), ResourceHandle.toRawSocket() o ResourceHandle.toRawDatagramSocket(), más de una vez ahora lanza un StateError.

• Se revirtió SendPort.send a las comprobaciones estrictas sobre el contenido de los mensajes al enviar mensajes entre isolates que no se sabe si comparten el mismo código.

• Eliminado Se eliminaron las API MirrorsUsed y Comment.

• Breaking changes to the preview feature @staticInterop:
  • No se permite que las clases con esta anotación utilicen constructores generativos external. Consulta 48730 y 49941 para más detalles.
  • No se permite que los miembros de extensión externos de las clases con esta anotación utilicen parámetros de tipo.
  • Las clases con esta anotación también deben tener la anotación @JS.
  • Las clases con esta anotación no pueden ser implementadas por clases sin esta anotación.

• dart2js ya no admite URI de HTTP como entradas.

• Se eliminó el soporte para mixin de clases que no extienden Object.

• Se cambió la propiedad uri de RedirectException en dart:io para que sea nulable.
• Se eliminaron las constantes en las API de red de dart:io que seguían la convención SCREAMING_CAPS.
• La Dart VM ya no restaura automáticamente la configuración inicial de la terminal al salir.

• Se descontinuó por completo el archivo .packages.

• Se eliminaron las herramientas independientes dart2js y dartdevc.
• Se eliminó la herramienta independiente dartanalyzer.

• Se añadió la nueva propiedad connectionFactory a HttpClient.
• Se añadió la nueva propiedad keyLog a HttpClient, que permite registrar claves TLS con fines de depuración.
• Se eliminaron constantes en dart:io siguiendo SCREAMING_CAPS
• Se añadió una nueva propiedad allowLegacyUnsafeRenegotiation a SecurityContext, que permite la renegociación de TLS para sockets seguros de cliente.

• Obsoleto Se declaró obsoleta la herramienta independiente dart2js.
• Obsoleto Se declaró obsoleta la herramienta independiente dartdevc.
• Eliminado Se eliminó la herramienta independiente dartdoc.

• En Windows, Directory.rename ya no eliminará un directorio si newPath especifica uno. En su lugar, se lanzará una FileSystemException.
• Eliminado Se eliminó la API Platform.packageRoot.

• Eliminado Se eliminó la API Isolate.packageRoot.

• Obsoleto Se declaró obsoleta la herramienta independiente dartanalyzer.
• Obsoleto Se declaró obsoleta la herramienta independiente dartdoc.
• Eliminado Se eliminó la herramienta independiente pub que estaba obsoleta.

• Se actualizó la clase SecurityContext para establecer la versión mínima del protocolo TLS en TLS1_2_VERSION (1.2) en lugar de TLS1_VERSION.

• Se eliminó por completo la biblioteca dart:web_sql.

• Se eliminó window.openDatabase (relacionado con la eliminación de dart:web_sql anterior).

• Se eliminó la herramienta independiente dart2native.
• Se eliminó la herramienta independiente dartfmt.

• Se eliminó el soporte para extensiones nativas estilo dart-ext:
• Se agruparon los isolates generados a través de la API Isolate.spawn() para que operen en el mismo montón (heap) administrado y, por lo tanto, compartan varias estructuras de datos internas de la VM.

• Los callbacks de configuración (setter) .authenticate y .authenticateProxy en HttpClient ahora deben aceptar un argumento realm nulable (para código con null safety migrado previamente).

• La mayoría de los tipos expuestos por esta biblioteca ya no se pueden extender, implementar ni mezclar (mixed-in).

• Los Expandos, y los parámetros object de Dart_NewWeakPersistentHandle y Dart_NewFinalizableHandle, ya no aceptan Pointer ni subtipos de Struct

• Se obsoletó la herramienta independiente dart2native
• Se obsoletó la herramienta independiente dartfmt.

• dart2js ya no es compatible con navegadores heredados (legacy), porque emite JavaScript ES6+ de forma predeterminada.

• Se cambiaron las relaciones de subtipado de las clases de package:js para que sean más correctas y consistentes con Dart2JS.

• Ya no es válido utilizar un String que coincida con una anotación @Native en una anotación @JS() para una clase de interoperabilidad JS no anónima.

• Null Safety ahora está habilitado de forma predeterminada en todo el código que no ha optado por excluirse.
• Se corrigió un error de implementación donde this a veces experimentaba una promoción de tipo en las extensiones.

• Se declararon obsoletas las invocaciones con un tipo genérico T de sizeOf<T>, Pointer<T>.elementAt(), Pointer<T extends Struct>.ref, y Pointer<T extends Struct>[]
• Se declaró obsoleto allocate en package:ffi, ya que no podrá invocar sizeOf<T> de forma genérica.
• Subtipos obsoletos de Struct sin ningún miembro nativo.

• Dart_WeakPersistentHandle ya no se auto-elimina cuando el objeto referenciado es recolectado por el recolector de basura para evitar condiciones de carrera.
• Se renombró Dart_WeakPersistentHandleFinalizer a Dart_HandleFinalizer y se eliminó su argumento handle.

• La restricción del SDK de Dart ahora es requerida en pubspec.yaml.

• Se renombró dart_api_dl.cc a dart_api_dl.c y se cambió a un archivo C puro.

• Al codificar una cadena que contiene sustitutos no emparejados (unpaired surrogates) como UTF-8, los sustitutos no emparejados se codificarán como caracteres de reemplazo (U+FFFD).
• Al decodificar UTF-8, los sustitutos codificados se tratarán como una entrada con formato incorrecto.
• Se cambió el número de caracteres de reemplazo emitidos para secuencias de entrada con formato incorrecto para que coincida con el estándar de codificación WHATWG al decodificar UTF-8 con allowMalformed: true.

• CssClassSet.add() y CssClassSet.toggle ahora devuelven false en lugar de null si el CssClassSet corresponde a múltiples elementos.

• Los compiladores web (dart2js y DDC) ahora producen un error en tiempo de compilación si dart:mirrors es importado.

• Al imprimir una cadena usando la función print, la implementación predeterminada imprimirá cualquier sustituto no emparejado en la cadena como caracteres de reemplazo (U+FFFD).
• La función Dart_StringToUTF8 en la API de Dart convertirá los sustitutos no emparejados en caracteres de reemplazo.

• Se corrigió un error de implementación donde la inferencia de variables locales utilizaba incorrectamente el tipo promovido de una variable de tipo.
• Se corrigió un error de implementación en torno a las cláusulas implements Function, extends Function, o with Function que ya no tienen efecto desde Dart 2.0.0.

• Se cambió el tipo de retorno de StreamSubscription.cancel() a Future<void>.
• Se dividió la función runZoned() en dos funciones: runZoned() y runZonedGuarded(), donde esta última tiene un parámetro onError requerido, y la primera no tiene ninguno.
• Los errores pasados a Completer.completeError(), Stream.addError(), Future.error(), etc. ya no pueden ser null.
• Se hicieron las trazas de pila (stack traces) no nulas.

• Tres miembros en RuneIterator ya no devuelven null cuando se accede antes de la primera llamada a moveNext().
• El valor predeterminado de defaultValue para String.fromEnvironment() ahora es una cadena vacía en lugar de null.
• El valor predeterminado para el parámetro defaultValue de int.fromEnvironment() ahora es cero.

• Se cambiaron Pointer.asFunction() y DynamicLibrary.lookupFunction() a métodos de extensión.

• Se cambió la firma de los métodos de HttpHeaders add() y set.
• La clase Socket ahora lanza una SocketException si el socket ha sido destruido explícitamente o actualizado a un socket seguro al establecer u obtener opciones de socket.
• La clase Process ahora lanza un StateError si el proceso está desvinculado (ProcessStartMode.detached y ProcessStartMode.detachedWithStdio) al acceder al getter exitCode.
• La clase Process ahora también lanza una excepción cuando no está conectada a la stdio del proceso hijo (ProcessStartMode.detached y ProcessStartMode.inheritStdio) al acceder a los getters stdin, stdout y stderr.
• El objeto ficticio (dummy) devuelto si fallan FileStat.stat() o FileStat.statSync() ahora contiene marcas de tiempo de la época de Unix en lugar de null para los getters accessed, changed y modified.
• La clase HeaderValue ahora analiza de forma más estricta en dos casos límite no válidos.

Corregimos varias inconsistencias entre DDC y Dart2JS para que los usuarios encuentren con menos frecuencia código que es aceptado por un compilador pero que luego falla en el otro.

• Se eliminó la versión heredada (basada en el analyzer) de DDC.
• Las funciones pasadas a JavaScript utilizando la especificación de interoperabilidad recomendada de package:js ahora deben envolverse con una llamada a allowInterop.
• Los constructores en clases @JS() deben estar marcados con external.

• Los límites (bounds) de los parámetros de tipo correspondientes ahora solo necesitan ser subtipos mutuos en lugar de ser estructuralmente iguales salvo por el renombrado de variables de tipo vinculadas e igualar todos los tipos top.
• Los tipos ahora están normalizados.
• Los constructores en clases @JS() deben estar marcados con external.
• Se eliminó por completo la bandera --package-root, que estaba oculta y deshabilitada en Dart 2.0.0.

• El SDK de Dart para macOS ahora solo está disponible para x64.

• Los miembros de extensión estáticos son accesibles cuando se importan con un prefijo.

• Se añadió IOOverrides.serverSocketBind para ayudar a escribir pruebas que deseen simular ServerSocket.bind.

• Se cambió la inferencia al usar valores Null en un contexto FutureOr. Es decir, las restricciones de formas similares a Null <: FutureOr<T> ahora producen Null como solución para T.

• La API ahora hace uso de miembros de extensión estáticos.
• Se eliminó la gestión de memoria Pointer.allocate y Pointer.free.
• Pointer.offsetBy fue eliminado, usa cast y elementAt en su lugar.

• Varios métodos y propiedades de diversas bibliotecas principales, que antes declaraban un tipo de retorno de List<int>, se actualizaron para declarar un tipo de retorno de Uint8List.

• Los parámetros posicionales opcionales name y value del constructor de la clase Cookie ahora son obligatorios.
• Los setters name y value de la clase Cookie ahora validan que las cadenas estén formadas por el conjunto de caracteres permitido y no sean nulas.

• Los paquetes publicados en pub.dev ya no pueden contener dependencias de git.

• Ahora se exige la covarianza de las variables de tipo utilizadas en las superinterfaces.

• Isolate.resolvePackageUri siempre lanzará un UnsupportedError cuando se compile con dart2js o DDC.

• Se corrigió un error en la clase StreamIterator donde await for permitía null como stream.

• El getter klass en la clase InstanceConstant en la API Kernel AST ha sido renombrado a classNode para mayor consistencia.
• Se actualizó la implementación de Link para utilizar enlaces simbólicos reales en lugar de uniones (junctions) en Windows.

• Añadir a un IOSink cerrado ahora lanza un StateError.

• Se corrigió una brecha de seguridad (soundness hole) al usar dart:mirrors para invocar de forma reflexiva un método de una manera incorrecta que infringe sus tipos estáticos.

• A number of static errors that should have been detected and reported were not supported in 2.0.0. These are reported now, which means existing incorrect code might show new errors:
  • Los mixins deben sobrescribir correctamente sus superclases.
  • Los argumentos de tipo implícitos en las cláusulas extends deben cumplir con los límites (bounds) de la clase.
  • Los miembros de instancia deben sombrear prefijos.
  • Las invocaciones de constructores deben usar una sintaxis válida, incluso con el uso opcional de new.
  • Los argumentos de tipo para los typedefs genéricos deben cumplir con sus límites (bounds).
  • Las clases no pueden implementar FutureOr.
  • Los métodos abstractos no pueden sobrescribir de forma insegura un método concreto.
  • Los constructores constantes no pueden redirigir a constructores no constantes.
  • No se permiten setters con el mismo nombre que la clase que los contiene.

• No se permiten claves duplicadas en un mapa const y producen un error en tiempo de compilación.

• Se reemplazó el sistema de tipos estático opcional no seguro por un sistema de tipos estático seguro (sound) que utiliza inferencia de tipos y comprobaciones en tiempo de ejecución, anteriormente llamado strong mode.
• Las funciones marcadas como async ahora se ejecutan sincrónicamente hasta la primera instrucción await.

• Se renombraron las constantes en las bibliotecas principales de SCREAMING_CAPS a lowerCamelCase.
• Se añadieron muchos métodos nuevos a las clases de las bibliotecas principales que deberán implementarse si implementas las interfaces de estas clases.
• dart:isolate y dart:mirrors ya no son compatibles al usar Dart para la web.

• Se reemplazó el sistema de construcción de pub basado en transformadores por un nuevo sistema de construcción.