[Перевод] Опубликованы jQuery 3.0 alpha и jQuery Compat 3.0 alpha16.07.2015 14:49

Поскольку эти методы добавляют атрибут style к элементу, они не смогут работать хорошо с техниками типа адаптивного дизайна, где видимость элементов может зависеть от media-запросов. Это приводит к необходимости обработчиков jQuery, которые слушают события orientationchange или resize, чтобы вручную скрыть или отобразить части страницы; это разрушает элегантность решения, которое пытались сделать через медиазапросы.

Вы можете видеть, что jQuery уже на полпути ко всеобщему безумию, и нет смысла так завершать путешествие. Особые случаи и проверки были бы не только сложными и неполными, но и вызвали бы существенные проблемы производительности на больших страницах.

Вместо этого, мы экспериментально игнорируем эволюцию этих методов и возвращаемся к простой изначальной модели. Это нарушит некоторый код. Если у вас есть элементы, в стилях которых прописаны display: none, метод .show () не будет переопределять это свойство. Таким образом, самое важное правило для перехода на jQuery 3.0 — это: Не используйте таблицы стилей, чтобы установить значение по умолчанию display: none, а затем пытаться использовать .show () — или другой метод, который показывает элементы — .slideDown () или .fadeIn () — чтобы сделать его видимым.

Если вам нужен элемент, который будет скрыт по умолчанию, лучше добавить имя класса типа «hidden» к элементу и определить, что класс будет display: none в стилях. Затем вы можете добавить или удалить этот класс, используя в jQuery методы .addClass () и .removeClass () для управления видимостью. Кроме того, вы можете иметь .ready () обработчик вызова .hide () на элементах, прежде чем они будут отображены на странице. Или, если вы действительно должны хранить стили по умолчанию, можно использовать .css («display», «block») (или другое значение display), чтобы переопределить стили.

Мы знаем, что это, вероятно, будет одним из самых спорных и сложных изменений в jQuery 3.0, поэтому мы хотели выложить в релиз его как можно раньше, чтобы увидеть эффект. Пожалуйста, дайте нам знать, как она влияет на ваш код и что необходимо изменить для того, чтобы работать с этой новой моделью.

github.com/jquery/jquery/issues/1767
github.com/jquery/jquery/issues/2057
github.com/jquery/jquery/issues/2308

Особый случай с именами в .data ()

Мы обновили нашу реализацию .data () для лучшего соответствия со спецификацией HTML5 по данным. Все ключи преобразованы из kebab-case в camelCase, независимо от способа доступа, и цифры больше не участвуют в преобразовании. Например, мы не различаем «foo-bar» и «fooBar», но различаем «foo-42» и «foo42». Эти изменения в основном будут играть роль при получении всех данных с помощью вызова .data () без аргументов или при попытке получить доступ к данным, используя преобразованный ключ .data («foo42») вместо оригинального .data («foo-42»).

github.com/jquery/jquery/issues/1751

jQuery.Deferred теперь совместим с Promises/A+

Объекты jQuery.Deferred были обновлены для совместимости с Promises/A+ и ES2015 Promises, проверяется по Promises/A+ Compliance Test Suite. Это означает введение метода .catch () и несколько крупных изменений в методе .then ():

• Исключение, в .then () обратного вызова теперь выставляет значение отказа. Ранее исключения пропускали всё, вплоть до прерывания коллбека и необратимо блокировали оба объекта Deferred — родителя и ребенка.
• Состояние разрешения в Deferred создаётся методом .then () и теперь контролируется его коллбеками — исключением стали значения отклонения, и non-thenable возвраты стали полноценно завершающими значениями. Ранее возвраты из обработчиков отклонения становились значениями отклонения.
• Коллбеки всегда вызываются асинхронно. Раньше они могли быть вызваны сразу после связывания или разрешения, в зависимости от того, что пришло последним.
• Коллбеки из Progress больше не могут разрешать объекты Deferred, к которым они привязаны.

Рассмотрим следующий код, в котором родитель Deferred отклоняется, и дочерний коллбек выбрасывает исключение:

var parent = jQuery.Deferred();
var child = parent.then( null, function() {
  return "bar";
});
var callback = function( state ) {
  return function( value ) {
    console.log( state, value );
    throw new Error( "baz" );
  };
};
var grandchildren = [
  child.then( callback( "fulfilled" ), callback( "rejected" ) ),
  child.then( callback( "fulfilled" ), callback( "rejected" ) )
];
parent.reject( "foo" );
console.log( "parent resolved" );

В jQuery 3.0 это выдаст «parent resolved» перед вызовом любого коллбека, каждый ребенок обратного вызова выдаст «fulfilled bar», и внуки будут отклонены с ошибкой «baz». В предыдущих версиях выдалось бы «rejected bar» (ребенок Deferred отклонен вместо выполнения) один раз, а затем выполнение прекратилось бы из-за с неперехваченной ошибки «baz» («parent resolved» не выводится и внуки остаются невыполненными).

В то время как пойманные исключения были преимуществом для отладки в браузере, это гораздо более декларативный (т.е. явный) способ обработать их с отказом от коллбека. Имейте в виду, что это требует от вас всегда добавлять хотя бы один отказ от коллбека при работе с промисами. В противном случае, любые ошибки останутся незамеченными.

Старое поведение можно восстановить путем замены .then () на ныне устаревший метод .pipe () (который имеет одинаковую сигнатуру).

jQuery.when был также обновлен, чтобы принять любой объект thenable, который включает в себя нативные промисы.

github.com/jquery/jquery/issues/1722
github.com/jquery/jquery/issues/2102

Удалены особые состояния Deferred методов в jQuery.ajax

Объект jqXHR это обещание (Promise), но он имеет дополнительные методы, такие как .abort (), так что вы можете остановить запрос после того, как он был сделан.

Поскольку пользователи всё чаще выбирают шаблон Promise для асинхронной работы типа AJAX, идея возврата особых состояний для Promise из jQuery.ajax не очень хороша.

success, error, complete
done, fail, always

Обратите внимание, что это не влияет на все обратные вызовы с тем же именем, которые продолжают существовать и не считаются устаревшими. Это влияет только на методы промисов!

github.com/jquery/jquery/issues/2084

Не игнорировать случаи ошибок

Возможно, в глубоких рассуждениях вы задавались вопросом «Что есть смещение окна?» Тогда вы, наверное, понимали, что это сумасшедший вопрос — как можно вообще давать смещаться окну?

Ранее jQuery иногда пыталась в таких случаях возвращать что-то осмысленное, а не выставлять ошибки. В данном случае при запросе смещения окна был ответ {top: 0, left: 0}. В этой альфа jQuery 3.0 мы экспериментируем с идеей выдавать в таких случаях ошибки, чтобы не игнорировать бессмысленные запросы. Пожалуйста, попробуйте альфу и посмотрите, есть ли код, зависящий от jQuery, скрывающий проблемы с неправильным кодом.

github.com/jquery/jquery/issues/1784

.width (), .height (), .css («width»), и .css («height») стали возвращать дробные значения (если позволяет браузер)

Ранее jQuery возвращал округлённые значения ширины и высоты. Некоторые браузеры возвращают субпиксельные значения — такие как IE и Firefox — и иногда пользователям нужна эта точность. Мы не ожидаем, что это изменение окажет большое влияние на ваш код, но дайте нам знать, если это происходит.

github.com/jquery/jquery/issues/1724

Удалены устаревшие псевдонимы событий

.load, .unload и .error объявлены устаревшими, начиная с jQuery 1.8. Используйте .on () для регистрации обработчиков.

github.com/jquery/jquery/issues/2286

jQuery.swap, jQuery.buildFragment и jQuery.domManip более недоступны

Эти методы всегда были только для внутреннего использования и не были задокументированы. Мы, наконец, сделали их приватными, чтобы избежать путаницы.

github.com/jquery/jquery/issues/2224
github.com/jquery/jquery/issues/2225

Анимации теперь используют requestAnimationFrame

На платформах, поддерживающих requestAnimationFrame API, кроме IE8–9, jQuery теперь использует этот API при анимации. Это должно дать более гладкие анимации, использовать меньше процессорного времени и сохранить батарею на мобильных устройствах.

jQuery пытался внедрить requestAnimationFrame несколько лет назад, но тогда были серьезные проблемы с совместимостью с существующим кодом. Мы думаем, что решили большинство этих вопросов путем приостановки анимации, когда вкладка браузера закрыта. Тем не менее, любой код, зависящий от анимации, и запускаемый практически в режиме реального времени, делает неверным это предположение.

.unwrap (selector)

До jQuery 3.0 метод .unwrap () не принимал аргументов. Аргумент selector указывает, какие обёртки нужно удалить.

github.com/jquery/jquery/issues/1744

Значительное ускорение для некоторых собственных jQuery-селекторов

Благодаря некоторой исследовательской работе Paul Irish в Google, мы определили некоторые случаи, когда могли бы пропустить кучу лишней работы, когда селекторы типа : visible используются много раз в документе. Это иногда улучшает скорость до 17 раз!

Имейте в виду, что даже при таком улучшении, селекторы типа : visible и : hidden могут быть затратными, потому что они зависят от браузера, чтобы определить, отображаются ли элементы на странице. Это может потребовать, в худшем случае, полного перерасчета CSS и макета страницы! Мы, не препятствуя их использованию, рекомендуем проверить страницы с такими селекторами на производительностью.

github.com/jquery/jquery/issues/2042

Благодарности

Большое спасибо всем, кто принимал участие в тестировании этого релиза, сообщая об ошибках, или предоставляя патчи, в том числе, по именам:

Все изменения

Здесь — полный список изменений со времён последних официальных релизов (1.11.3 и 2.1.4).

Общие для обоих релизов jQuery и jQuery Compat

Ajax

• Всегда использовать инъекции скрипта в globalEval (# 1449, bbdfbb4)
• Удалить JSONP-коллбеки через метод «jQuery#removeProp» (# 2323, a2ae215)
• удалить зависимость событий от модуля AJAX (4e7f34f)
• Исправление прерванного запроса в ajaxSend (# 1775, 598ed05)
• использовать тег якоря для разбора URL (# 1875, b091fdb)
• Fix обнаружения кросс-домена для нестандартного порта (83b038f)
• $.post И $.get теперь могут получать опции (# 1986, 89ce0af)
• упростить одиночный Ajax вызов и добавить пояснительный комментарий (0ac28ed)
• сделать jQuery#load поле «тип» явным (4ef120d)
• заменить «jqXHR.complete» callback на «always» (97ef1f2)
• удалить устаревшие расширения из Ajax promise (# 2084, 9d1b989)
• удалитm второй аргумент в jQuery#each (a4715f4)
• удалить обработчик «OnUnload» (a117dd0)
• Удалить остатки синонимов событий (38a6697)

Атрибуты

• добавить класс для SVG манипуляций (# 2199, 20aaed3)
• вернуть null, когда атрибут не существует (# 2118, aaeed53)
• Использовать опцию val hook в select val hook и упростить его (# 1902, f6302b0)
• удалить ненужные проверки на null (55ac56a)
• исправить тест возврата значения в new (5dc4616)
• вернуться к возвращению null для не-элементов (7632b74)
• вернуться к возвращению null для несуществующих атрибутов (+2905961)

Обратные вызовы

• Уменьшить размер (4cbf02d)
• Не прерывать выполнение на .lock () (# 1990, 32bf917)
• No object starts out locked (# 1989, 0d829f0)
• Отключение обратного вызова должно предотвратить запуск (# 1790, bc1cb12)

Ядро

• Вернуть пустой массив вместо null для parseHTML (») (# 1997, 4116914)
• использовать document.implemenation.createHTMLDocument в jQuery.parseHTML (58c2460)
• Следовать спецификации AMD для define (892625b)
• Выдать ошибку на $(»#»), а не возвращать коллекцию 0-й длины (80022c8)
• позволить инициализировать принятие альтернативного root jQuery для мигации sake (# 2101, 7a6931d)
• удалить ненужные тесты createHTMLDocument (+5923282)
• передать пустую строку в createHTMLDocument для IE (31c7d7f)
• вернуть добавление createHTMLDocument. Спасибо, Сафари 8. (b779831)
• Обновить проверки jsdom, выбросить устаревшие методы обхода (# 2153, 06f6cd1)
• вновь ввести createHTMLDocument в parseHTML; Сафари 8 игнорируется (cfe468f)
• Стандартизация IndexOf сравнения (53aa87f)
• удалить пользовательские события .ready (# 2264, c252c5f)
• Последовательно использовать локальную ссылку на access () (2fb719e)
• Удалить устаревшие контекст и свойства selector (# 1908, 0ea8c32)
• удалить isArray-подобную проверку нод (# 2238, 436f0ae)
• добавить поддержку элементов с тегами, разделёнными дефисом (534f130)
• Использование window.setTimeout & friends вместо глобальных эквивалентов (# 2177, 219c749)
• удалить size () и andSelf () методы (# 1749, f110360)
• удалить переменную strundefined (29838b6)
• Сделать jQuery объекты итерируемыми (# 1693, bb026fc)
• добавить обход для iOS ошибки JIT в isArrayLike (# 2145, 1541664)
• Проверить все случаи заводского использования от intro.js (# 2181, ab40725)
• Переход от модулей к только window.setTimeout т.д. (842958e)
• совместимость ветвей: удалить неиспользуемые переменные, добавить комментарии (f6de5a9)
• упростить тест «each» в итерациях стилей (fcb6c4d)
• Упростить и ускорить .each (eeda11c)
• организовать prop & attr коды похожими (5153b53)
• изменить сигнатуры jQuery.each и jQuery#each (# 2090, 2380028)

CSS

• CSS: Event: упрощение сигнатур нативных методов (85577a3)
• Fix тест «проверки вменяемости» («sanity check», 995f707)
• Удалить не-функциональный юнит-тест для отрицательного margin (4ab7431)
• Добавить интеграционный тест для gh-1764 (+8887106)
• Удалить использование getDefaultComputedStyle (# 15227, 274feb5)
• Использовать предопределенные display для html и body (a772418)
• Fix опечатки в комментарии (7e09619)
• исправить : visible/: hidden селекторы для инлайнового элемента с контентом (# 2227, 79bcb29)
• Поддержать relative adjustment в любом действующем блоке (# 1711, 9b03f6d)
• элементы скрыты, когда или offsetWidth, или offsetHeight равны нулю (# 10406 ​​, # 13132, 10399dd)
• Игнорировать каскадность CSS в show ()/hide ()/etc (# 1767, # 2071, 86419b1)
• Fix тест поддержки pixelMarginRight в Android 2.3 (cdfc2d0)
• Очистить утечку памяти в reliableMarginRight (# 1795, 7d15b4d)
• Не кешировать нестандартные свойства CSS (# 2015, d471842)
• Не именовать анонимную функцию подкачки (0019a46)
• сделать getStyles () функцию более читабельной (3a0d582)
• Работа по ошибкам полноэкранного режима в IE11 (# 1764, 90d828b)
• Добавить юнит-тест для отрицательных margin и позиционирования (1b932bb)
• упростить «defaultDisplay» модуль (c62486f)
• Сделать в .css («width») & .css («height») возврат дробных значений (# 1724, b60b26e)
• Не показывать jQuery.swap (# 2058, bb4d888)

Data

• не включать в себя цифры, если camelCasing (# 1751, 2862a07)
• всегда camelCase ключи в .data () (# 2257, 0e79098)
• Использовать объект PDF вместо Java апплет для тестирования acceptData (# 1938, 087d280)
• camelCasing не должны игнорировать регистр (# 2070, 172cad8)

Deferred

• Обратно совместимые стандарты взаимодействия (# 1722, 555a50d)
• Исправить $.when с resolved deferred and progress callbacks (# 1894, ab20d9d)
• добавить .catch обработчик (# 2102, 84ccf26)
• Always handle progress callbacks before done/fail (# 2013, # 2010, 002240a)

Размеры

• разрешить изменение координат аргумента (# 1848, f7e60dc)

Документы

• 1.x-master branch → compat branch; 2.x branch → master branch (758fd6c)
• правильная grunt команда в README.md (# 1850, 9d6beac)
• удалить избыточную инструкции из ридми (# 2359, 3c92770)
• Уточнить пользовательские инструкции сборки (a3779bc)

Эффекты

• Добавление тестов для jQuery.Animation (b3b2d6c)
• Вновь использовать requestAnimationFrame (# 15147, 72119e0)
• добавить тесты для jQuery.easing._default в Animation и Tween (6d7ef56)
• установить ослабление (easing) по умолчанию в jQuery.easing._default (# 2219, 5f2ea40)
• Добавить тесты для jQuery.Tween (cdaed15)
• Улучшить логику raf (708764f)

События

• удалить preDispatch hook и упростить «имитацию» сигнатуры (3655c4e)
• удалить guard для falsy обработчика аргумента jQuery#on метода (fac67a9)
• убрать события HTML5, наследуемые от MouseEvent (# 2009, d7e5fce)
• Полностью очистить события в юнит-тестировании (4467ed6)
• Пустые namespaces должны быть проигнорированы без происшествий (8653068)
• удалить устаревшие originalEvent хаки (6df669f)
• Удалить поддельные originalEvent из jQuery.Event.simulate (# 2300, 7475d5d)
• исправить ошибку неправильного окна со scrollTop/Left в фреймах (# 1945, d21edb5)
• удалить устаревшие псевдонимы событий (# 2286, 0705be4)
• Добавить примечание об ошибке MouseEnter в Chrome (a5e1c9b)
• Восстановление `constructor` property в jQuery.Event прототипе (# 15090, b807aed)
• Копировать свойство detail в jQuery.Event из родных событий (# 1867, d9ed166)
• удалить внутренний аргумент в методе .on () (04a2969)
• Нормализовать свойства событий мыши в событиях drag (# 1925, 97cf528)
• подробно комментировать focus (in | out) & rename support prop (c074006)
• удалить избыточные проверки методов событий (# 2047, a873558)

Манипуляция (DOM)

• улучшить тест для data-URI (dd596cc)
• добавить поддержку элементов с тегами, содержащими дефисы (# 1987, 85ffc6d)
• удалить внутренний аргумент метода remove () (# 2301, 349edbd)
• приватизировать функцию buildFragment () (# 2224, a74320f)
• не вставлять tbody автоматически (# 1835, e984d1c)
• Поддержка вставки data-URI скриптов (# 1887, 15f4dec)
• обнаруживать скрытый инпут ReplaceWith без содержания (# 2204, 4b27ae1)
• Сделать точку перехвата HTML (# 1747, 225bde3)
• увеличить задержку data-URI test (# 1993, 4fae911)
• приватизировать функции внутреннего domManip () (# 2225, 62d5579)
• упростить HTML обертки (# 2002, 0ea342a)
• сделать wrapAll funarg однократно выполняемым (# 1843, 359b03c)

Offset

• удалить проверку ownerDocument в offset getter (# 2115, 6176567)
• Округлить значения смещения ради ошибок с плавающей точкой (# 2147, 62ae2d0)
• вернуть нули (zeros) для отключенных / скрытых элементов (# 2310, 40dcc76)
• Fix .offset (), чтобы правильно работать с ShadowDOM (# 1784, 1617479)
• отсчет для прокрутки при определении позиции (# 1708, 2d71594)
• не запускать IFRAME тест scrollTop/scrollLeft в Android 2.3 и 4.0 (# 1981, 0c46643)
• вернуться ранее getBoundingClientRect, чтобы избежать ошибок в IE8–11 (0e4477c)
• добавить тесты для скрытых элементов + прокрутки (b041242)
• упростить метод jQuery#offsetParent (74ae544)

Selector/Sizzle

• добавить jQuery.uniqueSort; объявить устаревшим jQuery.unique () (# 2228, e1090c3)
• добавить тест для синонима jQuery.unique () (add85af)
• Удалить »#»-исключение для идентификаторов токенов (86e62d8)
• обновление 2.1.1 (7602dc7)

Wrap

• Поддержка .unwrap (selector) для выборочного удаления оболочек (# 1744, 7b09235)

Только для jQuery 3.0

Ajax

• Удалить обходной путь для IE6/7 (e519098)
• упростить метод jQuery.parseXML (5a0867d)

CSS

• сэкономить 20 байт в CSS/support (45ec73f)
• Свернуть двойной if в один (7855a1a)
• Восстановить хак, чтобы получить пиксели для .css ('width') и т.д. (3747cc6)

Data

• срезать пару байт (6f65f5f)
• избегать Object.defineProperties для нод (# 1728, 95fb798)
• избегать не буквенно-цифровые символы в свойствах expando (0cdec79)
• обновления element[expando] кеша (222ac3a)
• изменять кэш элемента до element[expando] (# 1734, d702b76)
• удалить неиспользуемый код (764dc94)
• удалить Expando, когда нет никаких данных (# 1760, 56bb677)
• ускорить $.fn.data () для camel-cased ключа (# 1941, 72c4a06)
• восстановить явное удаление приватных данных в cleanData (# 2127, 332fd94)
• удалить тесты, основанные на апплетах (# 1938, 95c0a10)

Манипуляция

• Приспособить XMLNode host object input для getAll (# 15151, 1ae025e)
• Проверить потерю состояния, если имя задано для Android 4.0–4.3 (1bbb678)

Offset

• Упрощение в if (+4287442)
• не запускать IFRAME тест scrollTop/scrollLeft в мобильном Safari (4ab8603)

Только jQuery Compat 3.0

Ajax

• Добавить комментарий поддержки и исправить проблему кода стиля (e38a94a)
• Запустить патч-тест только в IE8 на TestSwarm (# 1994, 2524da0)
• переместить пояснительный комментарий к соответствующему месту (04fc801)
• Использовать родной XHR для всех нелокальных запросов в IE9+ (# 1684, 61f812b)
• Переименовать Spartan в Edge в комментарии (8d88cd5)
• исправить запасную логику XHR для IE8 (bd699cb)

Атрибуты

• Использовать проверку typeof для метода getAttribute () (075da30)
• не проверять манипуляции с CSS-классом для SVG в IE8 (57fb2dc)
• исправить проблемы с IE8 (f2bcf87)

Обратные вызовы

• Изменить сломанный URL для одного обходного пути (e4cbc97)

Ядро

• Совместить код в intro.js в мастере (fe2a584)

CSS

• Добавить тест для хака .css ('marginRight') и подобных (25bc680)
• Fix альфа-прозрачностьв верхнем регистре в IE8 (# 1705, c5e8e12)
• упростить хак CSS getter для вычисляемых значений (dac716c)
• исправить порядок зависимостей для AMD (e185aa3)

Data

• использовать removeAttribute в cleanData для обхода бага Chrome (# 1664, 9d1d90e)

Deferred

• пройти lint в новых catch-тестах (203979d)

Эффекты

• Удалить ненужные операции в тестах (13040b6)
• исправить ошибки тестов в IE8 (fe6afa8)
• Fix тесты (29561bc)

События

• Добавить ссылку на модуль data (2866da9)
• исправить незакрытый комментарий (ac23f91)

Манипуляция DOM

• не проверить data-URI элемента script в IE8 (503e545)
• утечка памяти в IE8 в обнаружении noCloneEvent (# 1840, faf295a)
• Обновить элементы html5shiv (# 15241, a953389)
• не запускать тесты IE8 для тегов с дефисами (87bb713)

Offset

• разрешить сеттер offset для элементов, отключенных от DOM (# 2114, dc49f62)
• getBounding не возвращает ширину/высоту в IE8. Исправить тест. (3b1de11)
• исправить тест IFRAME scrollTop/Left для IE8 (d632699)
• исправить тест IFRAME scrollTop/Left для iPhone (62a333e)
• вернуть jQuery.contains для в IE8 (ветка Compat) (6df3990)
• нет необходимости проверять ownerDocument (523de77)

Traversing

• упростить метод jQuery#contents (7230df1)

© Habrahabr.ru