JavaScript-код должен работать предсказуемо в любой ситуации. Мы можем добавить в него огромное количество проверок, но тогда он станет громоздким, и его будет сложно сопровождать. Или можно добавить комментарии и подсказки, но это не защитит нас от неверного использования кода. В такой ситуации на помощь приходит TypeScript. Давайте разбираться, чем он полезен для JavaScript-разработчиков.

Что такое TypeScript?

TypeScript — строго типизированный язык программирования, основанный на JavaScript. Он состоит из трёх частей:

  • синтаксис языка программирования,
  • компилятор,
  • сервис для редактора.

Синтаксис TypeScript позволяет разработчику элегантно выразить решение задачи в виде текста в файле .ts или .tsx. Он является эволюцией синтаксиса JavaScript, поэтому любая программа JS синтаксически корректна на TypeScript.

Компилятор tsc помогает обнаружить множество дефектов до загрузки на продакшн. Он преобразует исходный текст TypeScript в JavaScript и анализирует программу, стараясь найти проблемные места. TypeScript может создать. js-файлы для любой версии JavaScript, начиная с ES3. Разработчик может диктовать TypeScript, какие правила анализа активировать, а какие — отключить.

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

Например, в JavaScript есть оператор try catch. В блок catch приходит значение с информацией об ошибке. Это значение может быть чем угодно, например, строкой, числом или объектом. В JavaScript разработчик на свой страх и риск использует «опыт и догадки». Один из вариантов поведения разработчиков — верить, что информация об ошибке будет типа Error.

В TypeScript можно заставить компилятор проверить использование значения в catch, а можно это правило отключить:

catch(err){
  console.log(err.message)
}

Будет ошибкой, если err — число 42.

Если поставить флаг компилятора useUnknownInCatchVariables, то компилятор не разрешит код из примера. Он заставит разработчика подумать, как выйти из положения, и тем самым снизит риск аварийного завершения программы.

Сервис для редактора выполняет такой же анализ, как и tsc-компилятор, но он это делает по мере того, как вы пишете программу. Есть множество редакторов с поддержкой TypeScript — например, с ним точно работают VS Code, Atom, WebStorm и Sublime Text. Если в списке нет редактора, которым вы пользуетесь, то для знакомства можете использовать песочницу TS Playground.

Онлайн-редактор TS Playground создан для изучения TypeScript. Он позволяет исследовать все важные аспекты этого языка программирования, подключить модули из npm, изучить назначения флагов компилятора, рассмотреть полученный JavaScript и текст определения модуля (.d. ts). При этом песочница обладает ограниченными возможностями для запуска полученного JavaScript.

Сервисы компилятора TypeScript сопровождают вас и указывают на ошибки, когда вы пишете код.

💫 Узнайте больше о теории типов, научитесь на практике использовать аннотацию типов и обобщённое программирование на профессиональном курсе по TypeScript.

Что говорит сообщество?

Опросы Stack Overflow в 2020 и 2021 годах показывают, что предпочтения профессиональных разработчиков и работодателей меняются. В рейтинге популярности языков программирования Stack Overflow за последние два года JavaScript сохраняет лидирующую позицию, но TypeScript стремительно его догоняет:

Популярность языка на SO

2020 г.

2021 г.

JavaScript

67%

65%

TypeScript

25%

30%

Статистика Github за четвёртый квартал 2021 года показывает аналогичную тенденцию:

Доля пулреквестов

Изменение к прошлому году

JavaScript

14.1%

-4.7%

TypeScript

8.5%

+1.8%

Разработчики часто обращают внимание на то, что новый сотрудник, и джун, и мидл, быстрее вливается в коллектив TypeScript-проекта, чем в коллектив JavaScript-проекта. Неудивительно, что для соискателя знание TypeScript становится преимуществом.

Исследования использования различных языков программирования на основе статистики пользователей Github показывают, что на TypeScript чаще всего переходят с других языков. Похоже, разработчики всё чаще забрасывают какой-нибудь CoffeeScript и начинают программировать на TypeScript.

Роль TypeScript в вашей работе

Создатели TypeScript ставят перед собой задачу: помочь разработчикам создавать и развивать продукты для любой системы, умеющей исполнять JavaScript, и добавить разработчикам уверенность в том, что программа будет выполняться предсказуемым образом.

Программы похожи на теоремы: они состоят из утверждений, и мы можем задуматься, нет ли в этих утверждениях противоречий. Нам это важно, потому что при наличии противоречий программа может ошибиться во время выполнения.

Убедиться в отсутствии противоречий в программе на TypeScript проще, чем сделать то же самое для программы на JavaScript. Всё дело в аннотации типов.

В TypeScript каждая переменная, функция и класс явно или опосредованно имеет специальные указания о том, значения какого типа в ней содержатся. Эти указания доступны не только для разработчика, но и для редактора и компилятора. Именно благодаря этим аннотациям сервисы TypeScript помогают находить логические противоречия в исходном коде.

Вот как можно озвучить работу сервисов TypeScript в таком отрывке:

const title = "TypeScript";
console.log(title.toUpperCase());
  1. Известно, что в JavaScript к строковому значению можно применить метод toUpperCase.
  2. В любой среде выполнения JavaScript есть console.log.
  3. Программист объявил неизменяемую переменную.
  4. Значение объявленной переменной — строка.
  5. Поскольку (1), (3) и (4), к переменной всегда можно применить метод toUpperCase.
  6. Вывод: поскольку (2) и (5), программа будет всегда исполняться.

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

Часто TypeScript сам догадывается о возможных действиях. Например, он хорошо ориентируется в примитивных значениях, унаследованных от JavaScript. В отношении кастомных типов разработчик может объяснить TypeScript свои намерения.

В этом и заключается ваше взаимодействие с TypeScript. Вы объясняете ему, какие значения хотите использовать, а он подсказывает, какие операции можно применять в разных ситуациях. Вот ещё один пример «рассуждений» TypeScript:

let title: string;
console.log(title.toUpperCase());

Разработчик объявил намерение использовать в переменной строковые значения. Переменная осталась неинициализированной. При отсутствии значения нельзя применять метод toUpperCase

После этих рассуждений TypeScript сообщает об ошибке Variable 'title' is used before being assigned до начала выполнения программы. Ещё до того, как вы закончите печатать вторую точку с запятой! К этому времени вы не успеете забыть, зачем объявили переменную title, и потратите меньше времени на исправление ситуации.

Часто способность TypeScript находить подобные дефекты и требовать от разработчика их устранения вызывает раздражение у начинающих программистов. Действительно, кому приятно признавать свои ошибки? Но с опытом приходит понимание, что подсказки компилятора важны для создания качественных продуктов.

TypeScript — это гораздо больше, чем сервис проверки типов. Он выполняет и другие задачи:

  • Определяет синтаксис, чтобы разработчик мог выразить намерение использовать значения определённого типа let title: string;.
  • Контролирует правомерность использования значения в контексте программы title.toUpperCase().
  • Сообщает разработчику об ошибочном использовании операций в отношении переменных прямо в редакторе, до запуска программы.
  • Даёт возможность разработки в методологии ООП. Ключевые слова private, protected, public, abstract, extends, implements.
  • Позволяет создавать JavaScript любой версии от JS3 и выше.
  • Даёт возможность использовать модули любого формата.
  • Открывает возможность обобщённого программирования. Дженерики позволяют создавать компоненты с реализацией алгоритмов в общем виде.
  • Позволяет работать в методике аспектного программирования через пока ещё нестандартные декораторы.
  • Позволяет создавать и дополнять аннотациями типов существующие библиотеки JavaScript. Да и стандартные тоже.
  • Компилирует JSX не только для React, вы можете предоставить свою реализацию createElement.
  • Интегрируется с Babel, Browserify, Grunt, Gulp, Jspm, MSBuild, NuGet, Rollup, Svelte Compiler, Vite, Webpack.
  • Является Open Source-проектом под «накидкой» Microsoft.

И это лишь часть полезных возможностей и особенностей TypeScript.

Несколько примеров помощи со стороны TypeScript

В процессе компиляции TypeScript создаёт красивый JavaScript. Вы можете убедиться в этом сами в песочнице TypeScript Playground. Для наглядности, вот что происходит с определением класса в старых версиях JavaScript:

TypeScript

class Example{}

Флаг компилятора -target=ES3

use strict";
var Example = /** @class */ (function () {
    function Example() {
    }
    return Example;
}());"

Согласитесь, удобнее написать одну строку на TypeScript и запустить компилятор, чем выписывать IIFE — непосредственно вызванное функциональное выражение.

Всегда рискованно создавать вручную необходимый инфраструктурный код, ведь ошибиться легко, а найти ошибку — сложно. TypeScript форматирует модули любого стандарта для вас. Вот как он отформатирует UMD-модуль. Сравните:

TypeScript

import { useState, useEffect } from "react";
interface ComponentProps {
    delay: number;
}

export const Component = (props: ComponentProps) => {
    const { delay } = props;
    const [elapsed, setElapsed] = useState(false);
    useEffect(() => {
        let cleaned = false;
        setTimeout(() => {
            if (cleaned) {
                return;
            }
            setElapsed(true);
        }, delay)
        return () => { cleaned = true; };
    }, [delay])

    return <h1>{elapsed ? 'loading' : 'completed'}</h1>
}

с результатом компиляции.

JavaScript-результат с флагом module=UMD

function (factory) {
    if (typeof module === "object" && typeof module.exports === "object") {
        var v = factory(require, exports);
        if (v !== undefined) module.exports = v;
    }
    else if (typeof define === "function" && define.amd) {
        define(["require", "exports", "react"], factory);
    }
})(function (require, exports) {
    "use strict";
    Object.defineProperty(exports, "__esModule", { value: true });
    exports.Component = void 0;
    const react_1 = require("react");
    const Component = (props) => {
        const { delay } = props;
        const [elapsed, setElapsed] = (0, react_1.useState)(false);
        (0, react_1.useEffect)(() => {
            let cleaned = false;
            setTimeout(() => {
                if (cleaned) {
                    return;
                }
                setElapsed(true);
            }, delay);
            return () => { cleaned = true; };
        }, [delay]);
        return React.createElement("h1", null, elapsed ? 'loading' : 'completed');
    };
    exports.Component = Component;
});

Где вы столкнётесь с TypeScript?

При использовании Angular: если разработчик захочет использовать инструменты Angular, ему придётся окунуться в TypeScript. Вы, конечно, можете продолжать «ангулярить» на JavaScript, но это будет непросто.

Другие популярные фреймворки и библиотеки не настолько категоричны, но все они поддерживают разработку на TypeScript. С одной стороны, это неудивительно, ведь TypeScript превращается в обычный JavaScript после компиляции. С другой стороны, участники проекта потратили ценные ресурсы на создание файлов с описанием типов. Следовательно, они рассматривают TypeScript в качестве стратегии развития.

Многие библиотеки, в частности, Redux, уже несколько последних версий создаются сначала на TypeScript и собираются в npm-пакеты после компиляции в JavaScript.

А ещё TypeScript позволяет методично и предсказуемо портировать кодовую базу из JavaScript. Мы предвидим, что разработчики, сопровождающие легаси-проекты этим воспользуются, и тогда вам точно пригодится знание TypeScript.

Что дальше?

TypeScript имеет родственную связь с JavaScript, но обладает собственным синтаксисом и самостоятельной системой компиляции. Умелое использование этих особенностей в проекте позволяет значительно снизить риски появления программных дефектов. С помощью TypeScript разработчик получает более предсказуемый результат в процессе разработки и рефакторинга. Но TypeScript требует знаний.

Для успешного использования TypeScript разработчики должны уметь создавать и описывать типы значений, понимать, как эти типы между собой взаимодействуют — значит, разработчикам придётся учиться. По нашему мнению, лучше приложить немного усилий для изучения TypeScript сейчас, чем позже прикладывать массу сил, чтобы избежать встречи с ним.

Должны ли вы применять TypeScript в каждом своем проекте и какой язык программирования лучше? На эти вопросы, скорее всего, нет ответа, потому что они неверно поставлены. Следует задать вопрос о том, какое преимущество тот или иной язык программирования принесёт вашему проекту. В этом случае в процессе развития проекта, при появлении новых запросов со стороны заказчика, TypeScript будет каждый раз более и более выгодным в сравнении с JavaScript.

Узнать больше


«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.

ТелеграмПодкастБесплатные учебники

Читать дальше

Ошибка JavaScript «Uncaught TypeError: Cannot read property of undefined». Что делать?

Описание проблемы
Эта ошибка возникает, когда вы пытаетесь получить доступ к свойству объекта, который в данный момент имеет значение undefined. Например:


let obj = undefined;
console.log(obj.property); // Uncaught TypeError: Cannot read property 'property' of undefined
  

Возможные причины

  • Объект не был инициализирован. Возможно, переменная еще не была объявлена или ей не присвоено значение.
  • Неправильный путь к данным. Вы пытаетесь обратиться к свойству объекта, но объект отсутствует в цепочке.
  • Асинхронность. Данные могли еще не загрузиться или быть доступны в момент обращения.
  • Опечатка в названии свойства. Вы могли неверно написать имя свойства объекта.

Шаги по исправлению

1. Проверка объекта перед доступом к свойствам

Убедитесь, что объект существует, прежде чем пытаться получить его свойства.

if (obj !== undefined && obj !== null) {
    console.log(obj.property);
}

// Или современный способ:
console.log(obj?.property); // Вернет undefined, если obj равен null или undefined
  

2. Инициализация объекта перед использованием

Если переменная должна содержать объект, убедитесь, что он инициализирован.

Неверный код:

let data;
console.log(data.user.name); // Ошибка
  

Исправление:


let data = { user: { name: "Иван" } };
console.log(data.user.name); // "Иван"
  

3. Проверка API или данных с сервера

Если данные загружаются с сервера, добавьте проверку, что ответ корректен.

fetch('https://api.example.com/data')
    .then(response => response.json())
    .then(data => {
        if (data?.user?.name) {
            console.log(data.user.name);
        } else {
            console.error('Данные пользователя отсутствуют');
        }
    });

4. Использование значений по умолчанию

Для предотвращения ошибок можно задавать значения по умолчанию.

let user = undefined;
let userName = user?.name || "Гость";
console.log(userName); // "Гость"

5. Отладка с помощью console.log

Проверяйте промежуточные значения переменных в консоли браузера.

console.log(obj); // Убедитесь, что объект определен 

Пример из жизни
Вы пишете код для отображения имени пользователя из объекта user:

let user = null; // Данные еще не загружены
console.log(user.name); // Uncaught TypeError: Cannot read property 'name' of null

Исправление:

let user = null;
console.log(user?.name || "Имя пользователя не найдено"); // "Имя пользователя не найдено"

Итог
Следуя этим рекомендациям, вы сможете избежать ошибок, связанных с доступом к свойствам undefined или null. Если ошибка продолжает появляться, убедитесь, что данные корректно загружаются, и используйте инструменты отладки.

JS
  • 15 ноября 2024

Как исправить ошибку JavaScript «Uncaught ReferenceError: variable is not defined»

Эта ошибка возникает, когда вы пытаетесь обратиться к переменной, которая не была объявлена в текущей области видимости. Например:

console.log(myVariable); // Uncaught ReferenceError: myVariable is not defined

Возможные причины

  • Вы пытаетесь обратиться к переменной до ее объявления.
  • Переменная объявлена внутри функции и недоступна за ее пределами.
  • Ошибка в написании имени переменной (опечатка).

Шаги по исправлению

1. Проверка объявления переменной

Убедитесь, что переменная объявлена перед ее использованием.

Неверный код:

console.log(myVariable); // Ошибка

Исправление:

let myVariable = 10;
console.log(myVariable); // 10

2. Правильное определение области видимости переменной

Если переменная объявлена внутри функции, она недоступна за ее пределами.

Неверный код:

function myFunction() {
    let localVariable = "Привет";
}
console.log(localVariable); // Ошибка

Исправление:

function myFunction() {
    let localVariable = "Привет";
    console.log(localVariable); // "Привет"
}
myFunction();

3. Использование глобальных переменных

Если переменная должна быть доступна везде, объявляйте ее глобально (но избегайте этого, если возможно).

let globalVariable = "Глобальная переменная";
function showVariable() {
    console.log(globalVariable);
}
showVariable(); // "Глобальная переменная"

4. Проверка имени переменной на ошибки

Проверьте, нет ли опечаток в имени переменной.

Неверный код:

let myVariable = "Данные";
console.log(myVarible); // Ошибка

Исправление:

let myVariable = "Данные";
console.log(myVariable); // "Данные"

5. Использование typeof для проверки существования переменной

Вы можете использовать оператор typeof, чтобы проверить, объявлена ли переменная.

if (typeof myVariable !== "undefined") {
    console.log(myVariable);
} else {
    console.log("Переменная не определена");
}

Пример из жизни
Вы пишете функцию для проверки данных пользователя:

function checkUser() {
    if (userName) {
        console.log(`Добро пожаловать, ${userName}!`);
    }
}
checkUser(); // Ошибка: userName не определен

Исправление:

let userName = "Иван";
function checkUser() {
    if (userName) {
        console.log(`Добро пожаловать, ${userName}!`);
    }
}
checkUser(); // "Добро пожаловать, Иван!"

Итог
Эта ошибка часто возникает из-за опечаток или неверной области видимости. Убедитесь, что переменные объявлены и доступны в нужных местах. Если необходимо, используйте typeof для проверки их существования.

JS
  • 15 ноября 2024

Как исправить ошибку JavaScript «Uncaught TypeError: Cannot set property of undefined»

Эта ошибка возникает, когда вы пытаетесь присвоить значение свойству объекта, который не существует (имеет значение undefined или null). Например:

let obj;
obj.property = "value"; // Uncaught TypeError: Cannot set property 'property' of undefined

Возможные причины

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

Шаги по исправлению

1. Инициализация объекта перед использованием

Убедитесь, что объект объявлен и инициализирован перед тем, как вы присваиваете его свойствам значения. Неверный код:

let obj;
obj.property = "value"; // Ошибка

Исправление:

let obj = {};
obj.property = "value"; // Работает

2. Проверка существования объекта перед доступом

Проверяйте объект на null или undefined, чтобы избежать ошибок. Пример:

let obj;
if (obj) {
    obj.property = "value";
} else {
    console.log("Объект не определен");
}

3. Использование опциональной цепочки

Если ошибка возникает в глубоко вложенных объектах, используйте опциональную цепочку. Пример:

let obj;
obj?.nestedProperty?.subProperty = "value"; // Не вызовет ошибку

4. Проверка асинхронных данных

Если объект формируется после загрузки данных, убедитесь, что данные доступны перед их использованием.

let obj;
setTimeout(() => {
    obj = { property: "value" };
    console.log(obj.property); // Работает
}, 1000);

// Нельзя обращаться к obj до инициализации:
console.log(obj.property); // Ошибка

Пример из жизни
Вы загружаете данные пользователя с сервера и пытаетесь установить свойство объекта:

let user;
user.name = "Иван"; // Ошибка

Исправление:

let user = {};
user.name = "Иван"; // Работает

Итог
Чтобы избежать ошибки «Cannot set property of undefined», убедитесь, что объект существует и инициализирован. Используйте проверки на null, опциональную цепочку или инициализируйте объект перед работой с его свойствами.

JS
  • 15 ноября 2024

Как исправить ошибку JavaScript «Uncaught SyntaxError: Unexpected token»

Эта ошибка возникает, когда интерпретатор JavaScript сталкивается с неожиданным токеном (символом) в коде, который нарушает синтаксические правила. Например:

let obj = { key: "value", }; // Uncaught SyntaxError: Unexpected token }

Возможные причины

  • Лишние или пропущенные символы, такие как запятые, точки с запятой, кавычки или скобки.
  • Неправильное использование синтаксиса, например, забытые конструкции или операторы.
  • Смешение разных типов кавычек (например, двойных и одинарных) без соблюдения правил их вложенности.

Шаги по исправлению

1. Проверка корректности синтаксиса

Убедитесь, что все запятые, точки с запятой и кавычки находятся на своих местах. Неверный код:

let obj = { key: "value", }; // Лишняя запятая

Исправление:

let obj = { key: "value" }; // Правильный синтаксис

2. Проверка закрытия скобок

Проверьте, закрыты ли все фигурные, круглые и квадратные скобки. Неверный код:

if (true {
    console.log("Ошибка!");
}

Исправление:

if (true) {
    console.log("Исправлено!");
}

3. Проверка типов кавычек

Не смешивайте одинарные и двойные кавычки. Неверный код:

let str = "Привет'; // Ошибка

Исправление:

let str = "Привет"; // Или let str = 'Привет';

4. Использование отладчика

Откройте консоль браузера или отладчик в вашей IDE, чтобы найти строку с ошибкой. Она будет указана в сообщении об ошибке.

// В консоли может быть указано:
Uncaught SyntaxError: Unexpected token } at script.js:10

Исправьте строку, где произошла ошибка.

5. Проверка работы кода в строгом режиме

Добавьте "use strict"; в начало вашего файла или функции, чтобы браузер проверял ваш код на соответствие строгому синтаксису.

"use strict";
let obj = { key: "value" };
console.log(obj);

Пример из жизни
Вы пытаетесь использовать стрелочную функцию, но забыли закрыть скобки:

const add = (a, b => {
    return a + b;
};

Исправление:

const add = (a, b) => {
    return a + b;
};

Итог
Чтобы избежать ошибок «Unexpected token», всегда проверяйте синтаксис вашего кода на наличие лишних или пропущенных символов, используйте инструменты отладки и следите за правильным использованием конструкций JavaScript.

JS
  • 15 ноября 2024
9 книг по JavaScript для начинающих в 2024

9 книг по JavaScript для начинающих в 2024

Все вокруг говорят, что книги — прошлый век. Но вовремя прочитанная хорошая книжка может здорово помочь в изучении нового языка или технологии, а то и вообще целиком объяснить какую-нибудь важную штуку. Например, какие бывают алгоритмы, или зачем нужен рефакторинг. К тому же, хоть фреймворки меняются каждый год, основы обычно долго не меняются.

Мы опросили знакомых разработчиков, узнали, что читают они сами, и предлагаем вам подборку хороших книг по JavaScript.

Читать дальше
JS
  • 6 марта 2024
Объект URL в JavaScript: полный разбор

Объект URL в JavaScript: полный разбор

Объект URL в JavaScript представляет URL-адрес и предоставляет удобные методы для работы с ним. Он позволяет анализировать, конструировать и декодировать URL-адреса.

Создать объект URL можно двумя способами:

Конструктор URL() — самый распространённый способ, в котором вы передаёте любой URL в виде строки в качестве аргумента.

const url = new URL("https://www.example.com/path?query=123#hash");

Использование window.location — это глобальный объект в браузерах, который содержит информацию о текущем URL.

const currentUrl = new URL(window.location.href);
Читать дальше
JS
  • 23 января 2024
Знакомство с JavaScript

Знакомство с JavaScript

Теперь, когда вы знаете, как создать структуру веб-страницы с помощью HTML и оформить ее стилями с помощью CSS, пришло время оживить её с помощью JavaScript (JS). JavaScript — это мощный язык программирования, который используется для создания интерактивных и динамических веб-сайтов.

Вы можете добавить JavaScript в ваш HTML-документ двумя способами:

Встроенный JavaScript: непосредственно в HTML-документ, в тегах <script>:

<script>
  alert("Привет, мир!");
</script>

Внешний JavaScript: подключение внешнего .js файла к HTML-документу:

<script src="script.js"></script>
Читать дальше
JS
  • 1 ноября 2023