4. Исходники и документация.

Практически все готово, чтобы двигаться дальше, но перед этим желательно зайти в раздел «downloads», на сайте https://nodejs.org и скачать исходный код Node.JS. Зачем это нужно? Node.JS содержит в себе как код на С++ так и JavaScript код для встроенных модулей. Многие встроенные модули написаны на JavaScript и потом, используя возможности V8, скомпилированы уже в выполняемые файлы и слинкованы с Node.JS. Для нас это не так важно, мы здесь  с С++ разбираться не будем, но если мы хотим залезть внутрь встроенных модулей, а нам иногда нужно будет это делать, чтоб понять как оно работает, то нужно эти встроенные модули скачать.

Screenshot_4_2

И разархивировать. Из под Windows, для разархивации, я воспользовался 7-Zip. Пришлось разархивировать дважды, сначала из «node-v4.4.7.tar.gz» у меня получился «node-v4.4.7.tar», потом уже просто папка с исходниками.

Итак, открываем исходники, заходим в директорию «lib», и вот эти файлы.

Screenshot_4_3

Обращаю ваше внимание, если вы просто поставили Node.JS из пакета, уже скомпилированный, готовый, в том числе и под Windows, то этих файлов не будет, и залезть например внутрь модуля «http.js», посмотреть что тут как происходит,  вы не сможете.

Screenshot_4_4

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

Документация.

Несколько слов по документации. Документацией мы будем пользоваться стандартной, вот она — https://nodejs.org/dist/latest-v4.x/docs/api/
тут достаточно много модулей. Если я хочу что то найти в документации, я обычно ищу так — Google -> nodejs console

Screenshot_4_5

Как видите первая же ссылка ведет нас на документацию. Переходите по ней и получаете необходимую информацию. На что хотелось бы обратить особое внимание, перейдя по ссылке вы обнаружите отдельную плашечку «Stability».

Screenshot_4_6

В Node.JS есть модули с различным уровнем готовности. Условно говоря от 0 до 3. Об этом можно почитать вот здесь About these Docs

Screenshot_4_7

Смысл такой, что 0 значит, что этот модуль не стоит использовать, а дальше от 1 до 3 различные степени стабильности. И фишка здесь в том, что стабильность, например «Experimental», то есть низкая, она не означает, что модуль плохо работает. Модули с такой стабильностью, могут работать замечательно, без единой ошибки. Стабильность означает лишь то, что API этого модуля, то есть набор функций, методов может в дальнейшем изменится. Соответственно использовать методы нестабильные можно, но стоит иметь ввиду, что они могут поменяться в будущем. При этом работать они могут вполне хорошо. Вот пожалуй все, что хотелось сейчас сказать про документацию. В дальнейшем мы будем к ней неоднократно  обращаться по мере углубления в разработку и изучение Node.JS.

Добавить комментарий

Ваш e-mail не будет опубликован.