Введение в программирование
2026-02-26 17:09 Diff
https://ru.hexlet.io/courses/introduction_to_programming/lessons/modules/theory_unit

Транскрипт урока

Представьте себе поселенцев, строящих свой первый маленький городок. В нём всего несколько зданий: пара домов, почта и вокзал. Он такой маленький, что люди могут указывать любое здание по названию: "давай встретимся у почты" или "я живу во втором доме", или "почему ты трезвый, уже 11 часов дня… пойдём ко мне… в дом номер 1".

Люди тогда много выпивали. Я слышал...

Короче, с ростом города строилось больше зданий. Вскоре людям пришлось делать выбор:

  • давать каждому новому зданию уникальный номер или название
  • дробить город на улицы

Конечно, они могли использовать первый способ и просто давать уникальные номера и названия новым строениям, чтобы никогда не было двух зданий с номером 5. Думаю, это подходящее, но не самое гениальное решение, особенно для крупного города. Мой адрес: "Нью-Йорк, здание 654 931". Да, ерунда какая-то.

Большинство выбирает второй путь: делить город на улицы, обычно — прямые линии, и идентификаторы домов — названия или цифры — становятся уникальными в пределах улицы. В городе много зданий с номером 5, но они все расположены на разных улицах, поэтому всё в порядке.

Именно поэтому в вашем компьютере есть папки. Без них все ваши файлы хранились бы в одном месте, и вы никогда бы не смогли иметь двух файлов с одним названием. Когда есть папки и вы создаёте новый файл, вам нужно заботиться об именах только в текущей папке.

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

Первые программисты были поселенцами в новом и странном мире компьютеров. Они столкнулись с подобной проблемой и встали перед выбором.

Они могли писать весь код в едином файле и тогда всё — численные и строковые константы, переменные и функции должны были бы иметь уникальные имена. А если бы они захотели переиспользовать какой-то код в другом проекте, им бы потребовалось копировать его из этого гигантского файла и вставлять его в другой гигантский файл.

Или они могли бы пойти вторым путем: разделить код на небольшие модули. Модули могут храниться в отдельных файлах, а имена функций и констант будут уникальными только в пределах файла, но не во всей программе. И модули можно легко переиспользовать в разных проектах, без копирования и вставки.

У разных языков программирования разные подходы к этой задаче. В JavaScript он довольно простой: один файл — один модуль. Все упражнения, которые вы выполняете в этом курсе — это написание модулей.

Всё хорошо, но теперь нам нужно как-то объединить код из разных файлов. Если вы просто напишете код в разных файлах, интерпретатор JavaScript не поймёт как получить что-то из другого файла.

Давайте посмотрим на пример: у меня есть файл, названный "math.js":

Это моя крошечная математическая библиотека.

Я создам другой файл, назову его "planets.js":

Этот второй файл не будет работать, потому что surfaceArea и square здесь не существуют. Они в отдельном файле, но JavaScript о нём не знает. Нам нужно сказать ему заглянуть в другой файл. Это называется "импортом" — давайте импортируем всё, что нам нужно:

Ключевое слово import, затем список того, что мы хотим в фигурных скобках, а затем название модуля. Файл в той же директории, что и "planets.js", поэтому "точка-слеш" говорит интерпретатору смотреть в текущей директории.

Когда вы импортируете что-то из Китая, что происходит в Китае? Верно, экспорт. Поэтому наша математическая библиотека должна исполнить свою роль — "экспортировать".

Просто укажите "export" перед чем угодно и это можно будет "импортировать" в другой файл. Тут мы экспортируем всё.

Возвратимся к "planets.js". Допустим, мы хотим импортировать что-то еще. Мы можем просто добавить названия в список:

Или импортировать всё сразу:

Тут говорится "импортировать весь модуль и назвать его "mathematics" в этом модуле". Теперь у нас есть доступ ко всему экспортированному из модуля math, но нам нужно сослаться на всё это через название "mathematics" таким способом:

mathematics точка что-нибудь.

Теперь смотрите: если мы добавим функцию square прямо сюда, никакой проблемы не возникнет:

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

И последнее: часто вам требуется экспортировать из модуля что-то одно. Существует специальный механизм, который называется "экспорт по умолчанию", и вы можете экспортировать с помощью него только что-то одно. Но экспортированную по умолчанию вещь проще импортировать.

Просто напишите код, как обычно, без специально указанных экспортов, а в конце выполните "export default что-нибудь". В данном случае мы экспортируем функцию surfaceArea.

Импорт по умолчанию выглядит так:

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

В сегодняшнем упражнении вы напишете модуль, и произведете экспорт и импорт функции самостоятельно.

Дополнение к уроку

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

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

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

  1. Внимательно изучите все импорты, описанные в начале файла. Так вы узнаете, какие модули и функции доступны внутри вашего файла (не считая глобальных функций и модулей, которые доступны и без импорта, например, Math).
  2. Попробуйте классифицировать импортируемые функции. Если импорт выглядит так from './..., то есть содержит ./, значит импортируется модуль, содержимое которого находится в текущей файловой системе. Это автоматически означает несколько вещей. Первое: вы всегда можете открыть этот файл и посмотреть, что там написано. Второе: вы не сможете импортировать этот модуль в другой среде (ведь этого файла там нет).
  3. Если from 'name' содержит только имя, без ./ в начале, значит модуль подгружается либо из стандартной библиотеки nodejs, либо из установленных пакетов. Визуально невозможно отличить одно от другого. Попробуйте загуглить имя таким способом: "nodejs name". Если в выдаче будет ссылка на официальную документацию, значит это модуль nodejs; если на репозиторий npm — значит, это обычный пакет, который почти наверняка лежит на гитхабе, что можно проверить таким запросом: "github js name", где "name" это имя пакета.

Расширение файла при импорте модуля

Указание расширения файла гарантирует, что он будет проанализирован как модуль в средах выполнения Node.js и d8, а также инструментом сборки Babel.

Если Babel разрешает опустить расширение файла, то официальная документация Node.js устанавливает конкретное требование: при использовании ключевого слова import необходимо указать расширение файла. Пути каталогов также должны быть полностью указаны — например, './startup/index.js'.

Этот подход обеспечивает идентичное поведение import в среде браузера и на сервере с типовой конфигурацией.

Выводы

Вы можете дробить код на отдельные модули. В JavaScript один модуль — это один файл.

Объединение кода, расположенного в разных модулях, происходит через:

  1. Экспорт чего-то из модуля.
  2. Импорт в другой модуль.

Экспорт и два способа импорта

Поставьте export перед тем, что вы хотите экспортировать. Такая операция сделает это импортируемым куда угодно:

Импортируйте специфичные штуки таким способом:

'./math.js' означает "из файла math.js, расположенного в той же (текущей) директории".

Или импортируйте всё:

Это значит: "импортировать весь модуль и назвать его mathematics в этом модуле". Вот почему к импортированным сущностям обращение происходит через mathematics вот так: mathematics.surfaceArea.

Экспорт по умолчанию

Вы можете сделать одну позицию экспортируемой по умолчанию.

Можно также экспортировать функцию или константу без имени:

Импортирование чего-то, что было экспортировано по умолчанию:

При экспорте функции без имени, её имя в модуле будет определяться в момент импорта, т.е. один и тот же экспорт может иметь разные имена в разных модулях:

math.js

import1.js:

import2.js: