23:null 24:["$","title",null,{"children":"Введение в требования | Сандро | Observable"}] 29:[] 27:{"id":"49917920df74bc20","slug":"untitled/4","title":"Введение в требования","thumbnail":"26faa141d971fd266aa96fef71dc88840ba6515a76fe9085b2d133ee02982cdd","access_level":"public","create_time":"$D2019-02-15T09:18:08.752Z","update_time":"$D2019-09-07T15:32:36.740Z","view_time":null,"first_public_time":"$D2019-09-07T15:33:44.393Z","has_unpublished_edits":null,"fork":{"id":"648c182c7b86b597","slug":"require","title":"Introduction to require","owner":{"id":"f35c755083683fe5","login":"observablehq","name":"Observable"}},"stars":2,"starred":false,"owner":{"type":"team","id":"0a9c12baacff9b60","login":"warsan","name":"Сандро","avatar_url":"https://avatars-next.observableusercontent.com/cf4f78e2c53176203f3eb5eb7ee079333d13912a4ee31aa34166dd94146f522f","tier":"starter_2024"},"version":397,"publish_version":397,"role":null,"authored":false,"authors":[{"type":"individual","id":"3a697b2116f96092","login":"warsan","name":"Сандро","avatar_url":"https://avatars-next.observableusercontent.com/cf4f78e2c53176203f3eb5eb7ee079333d13912a4ee31aa34166dd94146f522f","tier":null}],"members":[{"type":"individual","id":"3a697b2116f96092","login":"warsan","name":"Сандро","avatar_url":"https://avatars-next.observableusercontent.com/cf4f78e2c53176203f3eb5eb7ee079333d13912a4ee31aa34166dd94146f522f","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Введение в требования","cells":[{"id":0,"value":"md`# Введение в требования\n\n\\`require\\` позволяет использовать тысячи модулей JavaScript с открытым исходным кодом в своих записных книжках.\n\nЕсли вы можете придумать задачу, например, манипулирование датами, математику или музыку, то, возможно, уже есть модуль, который может помочь. Так же, как вы можете [повторить код из других ноутбуков, используя импорт](https://beta.observablehq.com/@mbostock/introduction-to-imports), вы можете запросить код из модулей JavaScript, используя _require_. \nВот пример использования _require_ для включения Simple Statistics, - модуля, который включает в себя множество статистических функций, а затем использование одной из этих функций для вычисления стандартного отклонения.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":20,"value":"simpleStatistics = require('simple-statistics')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":22,"value":"simpleStatistics.standardDeviation([1, 2, 3])","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"md`---\n\n## требование ввода\n\nАргумент функции require может быть любым из:\n\n**Имя модуля**\n\nНаиболее распространенный случай, когда вы просто хотите включить модуль. \nНапример, чтобы запросить [момент](https://momentjs.com/) из библиотеки даты и времени:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":137,"value":"moment = require('moment')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":222,"value":"moment('January 2, 2018').subtract(1, 'year').year()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":154,"value":"md`Это имя модуля также может включать _version_. \nВы можете включить [спецификатор семантической версии](https://semver.npmjs.com/), чтобы разрешить диапазон версий, как, например, оператор \\`require\\` ниже, который включает новейшую версию, соответствующую 2.x.x.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":156,"value":"moment2 = require('moment@2')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":140,"value":"md`**Имя модуля и путь**\n\nИногда нужно включить отдельный файл из модуля, а не его основной экспортируемый интерфейс. Это гораздо реже, но может быть полезно для модулей, у которых есть _addons_ или которые неправильно указывают unpkg, какой файл показывать по умолчанию. \nНапример, вот как мы можем включить модуль [Chart.js](http://www.chartjs.org/), имеющий файл AMD, который может использовать \\`require\\`, не указывая на него по умолчанию: (вместо автоматического определения мы указываем файл напрямую)`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":147,"value":"Chart = require('chart.js/dist/Chart.min.js') ","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":146,"value":"md`**URL**\n\nВы также можете указать полный URL-адрес для запроса - это сработает на любом сервере, а не только на unpkg. \nНапример, мы можем загрузить последнюю версию [ganja.js](https://github.com/enkimute/ganja.js) напрямую из GitHub (через [RawGit](https://rawgit.com/)).^*`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":162,"value":"ganja = require('https://cdn.rawgit.com/enkimute/ganja.js/master/ganja.js')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":279,"value":"md`**Несколько входов**\n\nУказание нескольких входных данных - несколько имен модулей, или URL, или имена модулей с путем, загрузят все именованные объекты и объединят их экспорт в один объект. Это особенно полезно для таких модулей, как составные модули D3.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":283,"value":"// Only load the DSV and Selection parts of D3, and combine their exports into one object\nd3CsvAndFetch = require(\"d3-dsv\", \"d3-selection\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":169,"value":"md`---\n\n## Требуемое возвращаемое значение\n\n\\`require\\` возвращает обещание с содержимым модуля или, если модуль не может быть загружен, отклоняет обещание.\n\nВ большинстве случаев вы будете использовать \\`require\\` в отдельной ячейке, как в приведенных выше примерах, поэтому вам не нужно беспокоиться об асинхронности возвращаемого значения. Но если вы хотите использовать \\`require\\` в контексте другого кода, вам нужно \\`дождаться\\` значения возвращаемого обещания.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":89,"value":"{\n // использование await для разрешения обещания, возвращенного по требованию\n let _ = await require('lodash');\n // используя модуль\n return _.filter([1, 2, 0]);\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":182,"value":"md` Иногда \\`require\\` не находит модуль или не может его загрузить - тогда он вернет отказ от обещания.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":185,"value":"notValid = require('not-a-real-npm-module')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":188,"value":"md`Если вы столкнётесь с проблемами \\`requiring a module\\`, попробуйте использовать [\\`require\\`-отладчика](https://beta.observablehq.com/@tmcw/module-require-debugger) или решить вопрос [на форуме](https: //talk.observablehq.com/).`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":93,"value":"md`---\n\n## require’s поведение\n\nПо умолчанию функция \\`require\\` использует модули, опубликованные в [NPM](https://www.npmjs.com/) службе, в которой размещено более 600 000 различных модулей^*, созданных тысячами отдельных разработчиков. Поскольку ноутбуки работают в веб-среде, мы используем другую службу [unpkg.com](https://unpkg.com/), которая принимает модули NPM и делает их доступными для браузеров.\n\nНапример, если мы вызываем \\`require\\` с аргументом \\`d3\\`, он расширяет этот аргумент до \\`http://unpkg.com/d3\\`, который затем перенаправляет на исходный код библиотеки визуализации D3:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":44,"value":"d3 = require('d3')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":106,"value":"md`Так что, если вы видите оператор \\`require\\` в блокноте, поиск его имени на [npmjs.com](http://npmjs.com/), скорее всего, приведёт к его подробностям - вот [пакет d3 на NPM](https://www.npmjs.com/package/d3), ссылающийся на информацию о GitHub и другую документацию.\n\n### Требования для require\n\nФункция require работает с модулями, включающими дистрибутивы AMD, которые указывают на них в полях \\`unpkg\\` или \\`main\\` их файлов \\`package.json\\`. ^* \nК сожалению, не все модули совместимы: некоторые полагаются на встроенные функции в Node.js, которые не имеют эквивалента в браузере, а другие не включают файл AMD, который \\`require\\` может использовать.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":66,"value":"md`---\n\n## способ import(): \\`require\\` модулей ES6\n\nВ дополнение к \\`require \\`, который использует широко поддерживаемый стандарт [AMD](https://github.com/amdjs/amdjs-api/blob/master/AMD.md), мы также поддерживаем \\`import()\\`, новый способ требования модулей, цель которого в конечном итоге избавить от необходимости пользовательских функций, таких как \\`require\\`.\n\n\\`import()\\` - это встроенная функция браузера, которая только сейчас приобретает популярность - она работает только в новейших версиях Chrome, Safari, Firefox и Edge. \nТакже requires модули были опубликованы в [спецификации модуля ES6](http://exploringjs.com/es6/ch_modules.html), которая все еще получает признание.\n\nКак и в \\`require\\`, мы добавили ярлык, чтобы вы могли ссылаться на модули по имени с помощью \\`import()\\`, и он будет загружать их с unpkg.com, если они доступны - или вы можете указать полный URL, и он будет извлечен из любого другого источника.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":75,"value":"scale = import('d3-scale')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":213,"value":"md`---\n\n## Сноски`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":241,"value":"urlNotes = md`- Если вы используете require с URL-адресом, URL-адрес и сервер, на которые он указывает, должны соответствовать нескольким требованиям:\n - URL-адреса только \\`https\\` (не \\`http\\`)\n - Для файла требуется правильный заголовок Content-Type, который будет использоваться в качестве JavaScript - например, \\`raw.githubusercontent.com\\` обслуживает файлы JavaScript как \\`text/plain\\`, которые ваш браузер не может выполнить как JavaScript - вот почему вместо этого мы часто используем RawGit.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":253,"value":"amdNotes = md`- require работает с _subset_ из модулей AMD, который включает подавляющее большинство таких модулей: строгая спецификация [находится в документации для d3-require](https://github.com/d3/d3-require#d3-require) , модуль, который обеспечивает \\`require()\\`.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":246,"value":"md`## Больше ресурсов\n\n- 🚢 [Введение в импорт](https://beta.observablehq.com/@mbostock/introduction-to-imports) (вроде требуется, но для обмена с ноутбука на ноутбук)\n- 🤔 [Require документация по устранению неполадок](https://beta.observablehq.com/@tmcw/requiring-modules-troubleshooting)\n- 🐛 [Модуль отладчика](https://beta.observablehq.com/@tmcw/module-require-debugger)\n- 📦 [d3-require, модуль, который питает \\`require\\`](https://github.com/d3/d3-require)`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W29","stdlib":"1"}} 28:"$27:body"