{"id":13394742,"url":"https://github.com/googlearchive/node-big-rig","last_synced_at":"2025-03-13T20:31:41.690Z","repository":{"id":74778138,"uuid":"45475020","full_name":"googlearchive/node-big-rig","owner":"googlearchive","description":"A CLI version of Big Rig","archived":true,"fork":false,"pushed_at":"2016-02-10T15:31:29.000Z","size":1101,"stargazers_count":409,"open_issues_count":6,"forks_count":28,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-05-13T21:22:48.209Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/googlearchive.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}},"created_at":"2015-11-03T15:16:26.000Z","updated_at":"2024-02-06T02:42:37.000Z","dependencies_parsed_at":"2023-04-30T07:05:47.160Z","dependency_job_id":null,"html_url":"https://github.com/googlearchive/node-big-rig","commit_stats":null,"previous_names":["googlechrome/node-big-rig"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlearchive%2Fnode-big-rig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlearchive%2Fnode-big-rig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlearchive%2Fnode-big-rig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlearchive%2Fnode-big-rig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/googlearchive","download_url":"https://codeload.github.com/googlearchive/node-big-rig/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243478188,"owners_count":20297210,"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":[],"created_at":"2024-07-30T17:01:30.093Z","updated_at":"2025-03-13T20:31:40.802Z","avatar_url":"https://github.com/googlearchive.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Node Big Rig\n\n[![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][depstat-image]][depstat-url]\n\nNode Big Rig comes in two flavors:\n\n1. A module for doing trace analysis inline to other tasks.\n2. A CLI tool.\n\n![Big Rig CLI](https://cloud.githubusercontent.com/assets/617438/10954268/5c977f4c-8344-11e5-9460-dc00e86970f3.png)\n\nBoth the module and CLI perform the same analysis as [the web app](https://github.com/GoogleChrome/big-rig), just without a UI. This makes it a good fit for use in CI environments, or as part of bigger workflows.\n\n## Installation\n\n### CLI\n\n```bash\nnpm install -g bigrig\n```\n\n### Module\n\n```bash\nnpm install bigrig\n```\n\n## Usage\n\n### CLI\n\nTo use the CLI you call `bigrig` and pass it the path to a trace file:\n\n```bash\nbigrig --file /path/to/trace.json\n```\n\nThis will, by default, simply return a JSON string that you can parse or manipulate as you see fit.\n\nIf you wish to see a pretty printed version, add the `--pretty-print` flag:\n\n```bash\nbigrig --file /path/to/trace.json --pretty-print\n```\n\nYou should then see a pretty printed output of the time breakdown for the trace.\n\n### Module\n\nYou can also use Big Rig's module as part of a wider workflow.\n\n```node\nvar bigrig = require('bigrig');\nvar fs = require('fs');\n\n// Read trace file contents.\nfs.readFile('/path/to/trace.json', 'utf8', function(err, data) {\n  if (err)\n    throw err;\n\n  results = bigrig.analyze(data);\n\n  // Now do something with the results, like\n  // post to a dashboard.\n});\n\n```\n\n## Getting a trace\n\nYou can get a trace from:\n\n* **[WebPagetest](http://webpagetest.org)**. Run your test with Chrome, and check \"Capture Dev Tools Timeline\" under the Chrome options. Download the timeline file (which is a trace file) and pass it to Big Rig.\n* **[Chrome DevTools](https://developers.google.com/web/tools/chrome-devtools/profile/evaluate-performance/timeline-tool?hl=en)**. Take a timeline recording, and then right click on the timeline, save the file, and pass it to Big Rig.\n* **[Big Rig's Test Runner](https://github.com/GoogleChrome/big-rig/tree/master/test-runner)**. This uses Chrome Driver under the hood, and will allow you to run an automated test (including for Android) and get back a trace file.\n\n**Please note:** you can only have one tab open when running the trace. If you have multiple tabs Big Rig won't be able to disambiguate and process the correct tab. You should also ideally disable any extensions you have running, as these can skew results. You can add the `--strict` flag if you want Big Rig to throw an error when it encounters extensions.\n\n## License\n\nSee /LICENSE\n\n## Owner\n\nPaul Lewis - [@aerotwist](https://twitter.com/aerotwist)\n\n## Thanks\n\nThe tracing code is a manipulated version of [Chrome's Trace Viewer](https://github.com/catapult-project/catapult/tree/master/tracing). A huge thanks to the Chromium engineers for making it possible to analyze traces.\n\nPlease note: this is not an official Google product.\n\n[npm-url]: https://npmjs.org/package/bigrig\n[npm-image]: https://badge.fury.io/js/bigrig.svg\n\n[travis-url]: https://travis-ci.org/GoogleChrome/node-big-rig\n[travis-image]: https://travis-ci.org/GoogleChrome/node-big-rig.svg?branch=master\n\n[depstat-url]: https://david-dm.org/GoogleChrome/node-big-rig\n[depstat-image]: https://david-dm.org/GoogleChrome/node-big-rig.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgooglearchive%2Fnode-big-rig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgooglearchive%2Fnode-big-rig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgooglearchive%2Fnode-big-rig/lists"}