{"id":13455458,"url":"https://github.com/MicrosoftDX/Vorlonjs","last_synced_at":"2025-03-24T08:32:35.655Z","repository":{"id":29356343,"uuid":"32890693","full_name":"MicrosoftDX/Vorlonjs","owner":"MicrosoftDX","description":"A new, open source, extensible, platform-agnostic tool for remotely debugging and testing your JavaScript. Powered by node.js and socket.io","archived":true,"fork":false,"pushed_at":"2023-12-01T01:10:51.000Z","size":92983,"stargazers_count":2924,"open_issues_count":66,"forks_count":259,"subscribers_count":86,"default_branch":"main","last_synced_at":"2024-10-29T15:20:50.209Z","etag":null,"topics":["dashboard","gulp","html","javascript","socket","typescript","vorlon"],"latest_commit_sha":null,"homepage":"http://www.vorlonjs.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MicrosoftDX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-03-25T21:03:35.000Z","updated_at":"2024-09-19T11:02:15.000Z","dependencies_parsed_at":"2024-01-13T10:43:07.224Z","dependency_job_id":"91ed5f83-e5bd-47b9-aa19-d53b1f254b67","html_url":"https://github.com/MicrosoftDX/Vorlonjs","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDX%2FVorlonjs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDX%2FVorlonjs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDX%2FVorlonjs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDX%2FVorlonjs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MicrosoftDX","download_url":"https://codeload.github.com/MicrosoftDX/Vorlonjs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245235453,"owners_count":20582231,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dashboard","gulp","html","javascript","socket","typescript","vorlon"],"created_at":"2024-07-31T08:01:05.704Z","updated_at":"2025-03-24T08:32:35.649Z","avatar_url":"https://github.com/MicrosoftDX.png","language":"TypeScript","readme":"# Vorlon.JS\n\nA new, open source, extensible, platform-agnostic tool for remotely debugging and testing your JavaScript. Powered by node.js and socket.io.\n\nUnderstand all about Vorlon.js in 20 minutes watching this video : https://channel9.msdn.com/Shows/codechat/046\n\nLearn more at [VorlonJS](http://vorlonjs.com) !\n\n![Build Status](https://jcorioland.visualstudio.com/DefaultCollection/_apis/public/build/definitions/593f5499-db9b-4e0f-ba42-fdd5d655592a/2/badge)\n\nChat with us on slack (get a free invite clicking on the badge below)\n\n[![Slack Status](https://slackinvorlon.azurewebsites.net/badge.svg)](https://slackinvorlon.azurewebsites.net/)\n\n## Deploy on Azure  \n [![Deploy to Azure](http://azuredeploy.net/deploybutton.png)](https://azuredeploy.net/)  \n\n## Easy setup\n\nInstall and run the Vorlon.JS server from npm:\n\n```console\n$ npm i -g vorlon\n$ vorlon\nWith the server is running, open http://localhost:1337 in your browser to see the Vorlon.JS dashboard.\n```\n\n**You may notice errors from Python, node-gyp and socket.io. This is a known issue already reported to socket.io team. This is not a blocking issue though as socket.io still works well even with this error :)**\n\n### Custom port\n\n[Linux]\n```sh\n$ PORT=3000 vorlon\n```\n[Windows]\n```sh\nc:\\\u003eSET PORT=3000 \u0026\u0026 vorlon \n```\n```sh\n//Vorlon listening on port 3000\n```\n\nThe last step is to enable Vorlon.JS by adding this to your app:\n\n```html\n\u003cscript src=\"http://localhost:1337/vorlon.js\"\u003e\u003c/script\u003e\n```\n\n## SSL Support\n\nIf you want to run the server with SSL support proceed as follows:\n\n1. Install Vorlonjs following the steps in Easy Setup\n2. Navigate to the installation folder\n3. Modify JSON file for activation SSL support\n4. In JSON file set to true \n5. If you want to replace our localhost certificate should only change the path of the files with the private key and certificate\n6. Exit and save JSON file\n\n## SSL Support on Azure\n\n1. Navigate to the installation folder\n2. Modify JSON file for activation SSLAzure support\n3. In JSON file set to true\n4. Exit and save JSON file\n5. Navigate with https protole on your Azure WebSite\n\nSample of azure hosted config.json file \n```console\n\n{\n    \"baseURL\": \"\",\n    \"useSSLAzure\": true,\n    \"useSSL\": false,\n    \"SSLkey\": \"cert/server.key\",\n    ....\n    ...\n}\n```\n## Custom log file\n\nBy default Vorlon.JS application logs with debug level and files are stored in the installation folder.\nIf you want to customize logs, proceed as follows :\n\n1. Navigate to the installation folder\n2. Modify JSON file, add or edit the \"logs\" section :\n * enableConsole : enabled logging to the console,\n * level : allowed values : info, warn, error\n * filePath : folder where log files should be store\n * vorlonLogFileName : name of Vorlon.JS log file,\n * exceptionsLogFileName : name of the log files for exceptions\n3. Exit and save JSON file\t\n\n```console\n[Windows]\nC:\\\u003ecd %HOMEPATH%\\node_modules\\vorlon\nC:\\Users\\Username\\node_modules\\vorlon\u003enotepad Server/config.json\n\n## JSON FILE ##\n{\n    \"useSSL\": true,\n    \"SSLkey\": \"server/cert/server.key\",\n    \"SSLcert\": \"server/cert/server.crt\",\n    \"includeSocketIO\": true,\n    \"plugins\": [\n        { \"id\": \"CONSOLE\", \"name\": \"Interactive Console\", \"panel\": \"bottom\", \"foldername\" : \"interactiveConsole\", \"enabled\": true},\n        { \"id\": \"DOM\", \"name\": \"Dom Explorer\", \"panel\": \"top\", \"foldername\" : \"domExplorer\", \"enabled\": true },\n        { \"id\": \"MODERNIZR\", \"name\": \"Modernizr\",\"panel\": \"bottom\", \"foldername\" : \"modernizrReport\", \"enabled\": true },\n        { \"id\" : \"OBJEXPLORER\", \"name\" : \"Obj. Explorer\",\"panel\": \"top\", \"foldername\" : \"objectExplorer\", \"enabled\": true },\n        { \"id\" : \"XHRPANEL\", \"name\" : \"XHR\",\"panel\": \"top\", \"foldername\" : \"xhrPanel\", \"enabled\": true },\n        { \"id\" : \"NGINSPECTOR\", \"name\" : \"ngInspector\",\"panel\": \"top\", \"foldername\" : \"ngInspector\", \"enabled\": false  }\n    ],\n\t\"logs\": {\n\t\t\"level\" : \"info\",\n\t\t\"enableConsole\" : true,\n\t\t\"filePath\" : \"E:\\\\temp\",\n\t\t\"vorlonLogFileName\": \"vorlonjs.log\",\n\t\t\"exceptionsLogFileName\":  \"exceptions.log\"\n    }\n}\n\nC:\\Users\\Username\\node_modules\\vorlon\u003evorlon\nVorlon with SSL listening on port 1337\n\nWith the server is running, open https://localhost:1337 in your browser to see the Vorlon.JS dashboard.\n```\n\nThe last step is to enable Vorlon.JS by adding this to your app:\n\n```html\n\u003cscript src=\"https://localhost:1337/vorlon.js\"\u003e\u003c/script\u003e\n```\n\n## Documentation\n\nRead further documentation about Vorlon.JS, and writing your own plugins at [http://vorlonjs.com/documentation](http://vorlonjs.com/documentation).\n\n## Developing on Vorlon.JS\n\nIf you wish to work on Vorlon.JS's server or core plugin code, you'll need to clone this directory and work in it.\n\nVorlon is written in typescript, which is compiled with gulp. There are two main directories:\n\n* [/Server](./Server) contains the code for the vorlon server, and the dashboard code\n * [/Server/Scripts](./Server/Scripts) contains the server and dashboard code\n * [/Server/public](./Server/public) contains the dashboard files served by express web server\n* [/Plugins](./Plugins) contains the code for vorlon core, and for the plugins\n *  [/Plugins/samples](./Plugins/samples) contains the sample client web page you can use to test your dashboard\n *  [/Plugins/Vorlon](./Plugins/Vorlon) contains the client infrastructure code\n *  [/Plugins/Vorlon/plugins](./Plugins/Vorlon/plugins) contains default plugins\n\n### Compiling from source\n\nThere is a `gulpfile.js` in the root folder of the repository. It contains gulp tasks to compile typescript to javascript for the plugins and the server. In addition it ensures that the compiled plugin code is copied in to the right place in the `Server` directory.\n\nTo compile everything (plugins, then server) run this:\n\n```\ngulp\n```\n\nTo compile only plugins run this :\n\n```\ngulp default-plugins\n```\n\nTo compile only server run this :\n\n```\ngulp default-server\n```\n\n### Compiling\n\nThe simplest way to run Vorlon.JS is to run `npm start` from the root directory. This will run both gulpfiles to compile typescript and start the server.\n\n### gulp watch\n\nYou can also run the gulp commands individually. This is useful if you wish to work on plugins in particular, as `gulp watch` will compile typescript for you automatically.\n\nIf you want to run `gulp` commands from command line, you will need to first install gulp globally on your system with:\n\n```console\n$ npm install -g gulp\n```\n\nYou can now run `gulp watch` in the root directory to have gulp compile typescript to javascript automatically You can also run `gulp watch-plugins` or `gulp watch-server` to only watch and compile the plugins or the server.\n\n#### Plugin test page\n\nThere is a demo webpage that includes the vorlon code that you can open to test the dashboard behaviour. It lives at [./Plugins/samples/index.html](./Plugins/samples/index.html). There is a gulptask in the `Plugins` gulpfile to host it, just run `gulp webserver`, and then navigate to [http://localhost:1338/index.html](http://localhost:1338/index.html) to view the page.\n\n### Visual Studio users\n\nFor Visual Studio users, we provide an integrated solution through VorlonJS.sln. In order to interact with Node.js, you just need to install the NodeJS Tool for Visual Studio [plugin](https://nodejstools.codeplex.com/).\nOnce the plugin is installed, just open the solution and you'll be ready to develop for Vorlon.js\n\n### Visual Studio Code users\n\nVisual Studio **Code** is a completly new code editor which is cross-platforms, free and light as hell ! You can do node.js debugging, there is intelliSense and so on (more about this on [Code Website](http://code.visualstudio.com)).\nThere also is a task workflow integration and we prepared you a [file in the repo](https://github.com/MicrosoftDX/Vorlonjs/blob/dev/.vscode/tasks.json) which contains all for you to be able to hit the Ctrl+Shift+B to run the default task in the gulp file.\n\n### Committing \u0026 Pull Requests\n\nOnce you've made a change, you can commit and submit a pull request to this repository. You will also need to electronically sign the Microsoft Contributor License Agreement ([CLA](https://cla.microsoft.com/)) if you wish for your changes to be merged.\n\nWhen committing changes, ensure that compiled JavaScript files (those compiled from TypeScript) are not committed, only the original TypeScript files should be committed.\n\n## Contributing\n\nRead [CONTRIBUTING.md](./CONTRIBUTING.md) for more info on contributing to Vorlon.JS.\n\n## License\n\nVorlon.JS is released under the MIT license. Please see [LICENSE](./LICENSE) for full details.\n","funding_links":[],"categories":["目录","TypeScript","Integrations","typescript"],"sub_categories":["测试/工具/Mock","Debugging"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMicrosoftDX%2FVorlonjs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMicrosoftDX%2FVorlonjs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMicrosoftDX%2FVorlonjs/lists"}