Практические руководства
Конвертер jQuery в чистый JavaScript
Содержание статьи
Найдите метод jQuery и получите его аналог на чистом JavaScript, а затем вставьте свой код в окно проверки — страница отметит вызовы, удалённые в jQuery 4.0 (например, $.isArray, $.trim, $.parseJSON), устаревшие и изменившие поведение. Всё работает в браузере, код никуда не отправляется.
Содержание
Как пользоваться конвертером
Страница работает в браузере и ничего никуда не отправляет. Над таблицей есть строка поиска и фильтр по статусу: введите название метода, например trim или hover, и останутся только подходящие строки. Ниже — окно «Проверить код»: вставьте в него фрагмент своего скрипта, и страница найдёт вызовы, которые удалены в jQuery 4.0, устарели или изменили поведение, и покажет чем их заменить.
Таблица доступна и без JavaScript: поиск и проверка кода включаются, когда страница загрузится. Данные актуальны на ноябрь 2026 года, на момент выхода jQuery 4.1.0 и 3.8.0.
Строка поиска и окно проверки кода появятся здесь после загрузки страницы. Таблица ниже доступна сразу.
Таблица соответствий: jQuery и чистый JavaScript
Колонка «Статус» показывает судьбу метода в jQuery 4: «работает» — метод остался без изменений, «устарело, но работает» — он есть в 4.x, но в документации помечен как нежелательный, «удалено в 4.0» — вызов приведёт к ошибке. Строки «изменилось в 4.0» описывают тонкие различия поведения.
| jQuery | Чистый JavaScript | Статус в jQuery 4 | Примечание |
|---|---|---|---|
| Выбор элементов | |||
$(".item") | document.querySelectorAll(".item") | Работает | Возвращает статический список NodeList, а не набор jQuery. |
$("#id") | document.getElementById("id") | Работает | Вернёт один элемент или null. |
$el.find(".a") | el.querySelectorAll(".a") | Работает | |
$el.closest(".box") | el.closest(".box") | Работает | Метод closest() есть во всех браузерах, которые поддерживает jQuery 4. |
$el.parent() | el.parentElement | Работает | |
$el.children() | el.children | Работает | Живая коллекция HTMLCollection; для методов массива оберните в Array.from(). |
$el.next() / $el.prev() | el.nextElementSibling / el.previousElementSibling | Работает | |
$el.is(".active") | el.matches(".active") | Работает | |
$(".a").eq(2) | document.querySelectorAll(".a")[2] | Работает | Отрицательные индексы в jQuery считались с конца; в JavaScript используйте .at(-1) у массива. |
$("li:first") | document.querySelector("li") | Устарело, но работает | Позиционные селекторы (:first, :last, :eq(), :even, :odd, :gt(), :lt()) устарели с jQuery 3.4. |
| Классы и атрибуты | |||
$el.addClass("on") | el.classList.add("on") | Работает | |
$el.removeClass("on") | el.classList.remove("on") | Работает | |
$el.toggleClass("on") | el.classList.toggle("on") | Работает | Второй аргумент-условие поддерживается и там, и там: toggle("on", flag). |
$el.toggleClass(flag) | el.classList.toggle("on", flag) | Удалено в 4.0 | Вызов .toggleClass(true/false) без имени класса удалён в jQuery 4.0: всегда указывайте класс. |
$el.hasClass("on") | el.classList.contains("on") | Работает | |
$el.attr("href") | el.getAttribute("href") | Работает | |
$el.attr("href", url) | el.setAttribute("href", url) | Работает | |
$el.removeAttr("title") | el.removeAttribute("title") | Работает | |
$el.prop("checked") | el.checked | Работает | Состояние флажка читают через свойство, а не .attr("checked"). |
$el.val() | el.value | Работает | Для <select multiple> значения придётся собрать из selectedOptions. |
$el.data("id") | el.dataset.id | Работает | Нативный dataset всегда возвращает строки, jQuery пытается привести тип. |
$el.data().hasOwnProperty("k") | "k" in $el.data() | Изменилось в 4.0 | Объект от .data() в jQuery 4 не наследуется от Object.prototype, поэтому hasOwnProperty может отсутствовать. |
| Содержимое и DOM | |||
$el.text() | el.textContent | Работает | |
$el.html(str) | el.innerHTML = str | Работает | Не подставляйте данные пользователя без экранирования. |
$el.append(x) | el.append(x) | Работает | |
$el.prepend(x) | el.prepend(x) | Работает | |
$el.before(x) / $el.after(x) | el.before(x) / el.after(x) | Работает | |
$el.remove() | el.remove() | Работает | |
$el.empty() | el.replaceChildren() | Работает | |
$el.clone(true) | el.cloneNode(true) | Работает | Нативный cloneNode не копирует обработчики событий. |
| Стили и размеры | |||
$el.css("color", "red") | el.style.color = "red" | Работает | |
$el.css("width", 100) | el.style.width = "100px" | Изменилось в 4.0 | В jQuery 4 единицу px число получает только для ограниченного набора свойств; для остальных пишите единицу явно. |
$el.css("color") | getComputedStyle(el).color | Работает | |
$el.show() / $el.hide() | el.hidden = false / el.hidden = true | Работает | Атрибут hidden работает, если ваш CSS не переопределяет display. |
$el.width() | el.getBoundingClientRect().width | Работает | Метод jQuery возвращает ширину содержимого, а нативный прямоугольник включает рамки и отступы. |
$el.offset() | el.getBoundingClientRect() | Работает | Координаты относительно окна; прибавьте window.scrollX/scrollY для положения в документе. |
$el.animate({opacity: 0}, 300) | el.animate({ opacity: [1, 0] }, { duration: 300, fill: "forwards" }) | Работает | Web Animations API; простые случаи решает CSS-переход. |
$.fx.interval | не нужен | Удалено в 4.0 | Свойство удалено в 4.0: анимации используют requestAnimationFrame. |
| События | |||
$el.on("click", fn) | el.addEventListener("click", fn) | Работает | |
$(document).on("click", ".btn", fn) | document.addEventListener("click", (e) => { | Работает | Делегирование: один обработчик на родителе. |
$el.off("click", fn) | el.removeEventListener("click", fn) | Работает | Нужна та же ссылка на функцию. |
$el.one("click", fn) | el.addEventListener("click", fn, { once: true }) | Работает | |
$el.trigger("click") | el.click() или el.dispatchEvent(new Event("click")) | Работает | Для своих событий используйте CustomEvent. |
$el.click(fn) | el.addEventListener("click", fn) | Устарело, но работает | Короткие записи событий (.click(), .focus(), .blur() и другие) устарели с jQuery 3.3. |
$el.hover(a, b) | el.addEventListener("mouseenter", a); el.addEventListener("mouseleave", b) | Устарело, но работает | Метод .hover() устарел с jQuery 3.3. |
$el.bind("click", fn) | el.addEventListener("click", fn) | Устарело, но работает | .bind(), .unbind(), .delegate(), .undelegate() устарели с jQuery 3.0; в 4.0 они ещё есть. |
$el.live("click", fn) | document.addEventListener("click", ...) | Удалено до 4.0 | Метод удалён в jQuery 1.9. Замена — делегирование через .on(). |
$el.load(fn) | el.addEventListener("load", fn) | Удалено до 4.0 | Короткие записи .load(fn), .unload(fn), .error(fn) удалены в jQuery 3.0. Не путайте с .load(url) — загрузкой HTML. |
$(function () { ... }) | document.addEventListener("DOMContentLoaded", () => { ... }) | Работает | Если скрипт подключён с defer или в конце страницы, обёртка не нужна. |
| Ajax и данные | |||
$.ajax({ url, method }) | fetch(url, { method }) | Работает | fetch() не считает ошибкой ответ с кодом 404 или 500, проверяйте response.ok. |
$.get(url, data) | fetch(url + "?" + new URLSearchParams(data)) | Работает | |
$.post(url, data) | fetch(url, { method: "POST", body: new URLSearchParams(data) }) | Работает | |
$.getJSON(url) | fetch(url).then((r) => r.json()) | Работает | |
$.ajax({ dataType: "json" }) на чужой домен | fetch(url, { mode: "cors" }) | Изменилось в 4.0 | В jQuery 4 JSON-запрос больше не превращается в JSONP сам: нужен CORS или явный dataType: "jsonp". |
$form.serialize() | new URLSearchParams(new FormData(form)).toString() | Работает | Файлы в такую строку не попадут. |
| Утилиты | |||
$.isArray(x) | Array.isArray(x) | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.isFunction(x) | typeof x === "function" | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.isNumeric(x) | !isNaN(parseFloat(x)) && isFinite(x) | Удалено в 4.0 | Удалено в jQuery 4.0; официальная рекомендация — Number.isFinite или своя проверка. |
$.isWindow(x) | x != null && x === x.window | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.parseJSON(str) | JSON.parse(str) | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.trim(str) | str.trim() | Удалено в 4.0 | Удалено в jQuery 4.0. Прежняя функция превращала null в пустую строку: String(str ?? "").trim(). |
$.type(x) | typeof x / Array.isArray(x) / Object.prototype.toString.call(x) | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.now() | Date.now() | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.nodeName(el, "div") | el.nodeName.toLowerCase() === "div" | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.camelCase(s) | s.replace(/-([a-z])/g, (m, c) => c.toUpperCase()) | Удалено в 4.0 | Удалено в jQuery 4.0. |
$.unique(arr) | $.uniqueSort(arr) | Удалено в 4.0 | Удалено в jQuery 4.0: используйте $.uniqueSort(). |
$.inArray(v, arr) | arr.indexOf(v) или arr.includes(v) | Работает | |
$.grep(arr, fn) | arr.filter(fn) | Работает | |
$.map(arr, fn) | arr.map(fn) | Работает | Функция $.map() выбрасывает null и разворачивает вложенные массивы, map() — нет. |
$.each(arr, fn) | arr.forEach(fn) | Работает | В $.each порядок аргументов (индекс, значение), в forEach — (значение, индекс). |
$.extend({}, a, b) | { ...a, ...b } или Object.assign({}, a, b) | Работает | Для глубокого копирования используйте structuredClone(). |
$.makeArray(list) | Array.from(list) | Работает | |
$.contains(a, b) | a !== b && a.contains(b) | Работает | |
$.Deferred() / .done() | new Promise() / .then() | Работает | Slim-сборка jQuery 4 больше не содержит Deferred. |
| Устаревшее | |||
$el.andSelf() | $el.addBack() | Удалено до 4.0 | Удалено в jQuery 3.0. |
$el.size() | $el.length | Удалено до 4.0 | Удалено в jQuery 3.0. |
$el.context / $el.selector | нет аналога | Удалено до 4.0 | Свойства удалены в jQuery 3.0. |
$.browser.msie | проверка возможностей: "fetch" in window | Удалено до 4.0 | Удалено в jQuery 1.9; определяйте поддержку возможностей, а не название браузера. |
$el.toggle(fn1, fn2) | переключение флага или класса в одном обработчике | Удалено до 4.0 | Версия .toggle() с двумя обработчиками клика удалена в jQuery 1.9. |
$el.push / $el.sort / $el.splice | [].push.call($el, x) | Удалено в 4.0 | Эти методы прототипа удалены в jQuery 4.0. |
Пример проверки кода
Допустим, в старом скрипте встречаются такие строки:
var items = $.map(list, fn);
if ($.isArray(items) && $.trim(title) !== "") {
$("#menu").hover(openMenu, closeMenu);
}
Проверка покажет три замечания: $.isArray() удалена в jQuery 4.0 (замена — Array.isArray()), $.trim() удалена в jQuery 4.0 (замена — title.trim()), а .hover() устарела с jQuery 3.3, но ещё работает (замена — события mouseenter и mouseleave). Строка с $.map() замечаний не вызовет: функция осталась в jQuery 4.
После правки получится:
const items = list.map(fn);
if (Array.isArray(items) && title.trim() !== "") {
const menu = document.getElementById("menu");
menu.addEventListener("mouseenter", openMenu);
menu.addEventListener("mouseleave", closeMenu);
}
Проверка ищет вызовы по шаблонам и не понимает контекст: она не отличит метод jQuery от одноимённого метода другой библиотеки и не увидит вызовы, имена которых собираются в коде динамически. Поэтому после правок всё равно запустите страницу вместе с jQuery Migrate и посмотрите консоль браузера.
Когда jQuery заменять не нужно
- Проект стабильно работает на jQuery 3.x или 4.x, а код пишете не только вы: сначала обновитесь по инструкции jQuery 4.0: что нового, а замену на чистый JavaScript делайте по мере правок.
- На странице много плагинов, которые зависят от jQuery: переписывать их ради самой замены нет смысла.
- Нужны сложные цепочки с очередью анимаций или сложная работа с событиями: нативный код получится длиннее. Сравнение подходов — в статье jQuery и чистый JavaScript.
- Для разовых прототипов проще не менять привычные инструменты.
Частые вопросы
Как заменить jQuery чистым JavaScript?
Для большинства методов есть прямой аналог: $(".a") заменяется на document.querySelectorAll(".a"), .addClass() — на classList.add(), .on() — на addEventListener(), $.ajax() — на fetch(). В таблице выше собраны самые частые соответствия, а также указано, в каких случаях поведение отличается.
Какие методы jQuery удалены в 4.0?
В jQuery 4.0 удалены функции jQuery.isArray, isFunction, isNumeric, isWindow, parseJSON, trim, type, now, nodeName, camelCase, unique, свойства jQuery.cssProps и jQuery.fx.interval, сигнатура .toggleClass(boolean), а также методы push, sort и splice прототипа jQuery.
Как проверить, что мой код совместим с jQuery 4?
Вставьте код в окно проверки на этой странице, затем подключите jQuery 4 вместе с jQuery Migrate 4.x на тестовой копии сайта и посмотрите предупреждения в консоли браузера. Migrate сообщает о вызовах, которые удалены или изменили поведение.
Куда отправляется код из окна проверки?
Никуда. Проверка выполняется в вашем браузере, текст не передаётся на сервер и не сохраняется.
Работает ли таблица без JavaScript?
Да, все строки таблицы видны сразу. JavaScript нужен только для строки поиска, фильтра по статусу и проверки вставленного кода.
Ещё по теме
- jQuery 4.0: что нового и как перейти с версии 3.x
- Как подключить jQuery: CDN, локальный файл, npm и WordPress
- jQuery и чистый JavaScript: аналоги методов и когда jQuery ещё нужен
- События в jQuery: .on(), .off(), делегирование и объект event
- Ajax в jQuery: $.ajax, $.get, $.post и отправка форм без перезагрузки
- Селекторы jQuery: шпаргалка с примерами для jQuery 3.x и 4.0
- Формы в jQuery: значения полей, чекбоксы, select и валидация
- Устаревшие и удалённые методы jQuery: что убрали в 1.9, 3.0 и 4.0 и чем заменить