{"id":18294,"library":"ember-cli-deploy-progress","title":"ember-cli-deploy-progress","description":"Flexible ASCII progress bar for Node.js, forked from the popular 'progress' package by visionmedia with an added cursor feature for the last completion character. Current stable version is 1.3.0. Release cadence is low; this is a specialized fork maintained by the ember-cli-deploy organization. Key differentiators include support for custom tokens, a cursor character distinct from the completion character, and a render throttle option. Commonly used in CLI tools and download progress displays.","status":"active","version":"1.3.0","language":"javascript","source_language":"en","source_url":"git://github.com/ember-cli-deploy/node-progress","tags":["javascript","cli","progress"],"install":[{"cmd":"npm install ember-cli-deploy-progress","lang":"bash","label":"npm"},{"cmd":"yarn add ember-cli-deploy-progress","lang":"bash","label":"yarn"},{"cmd":"pnpm add ember-cli-deploy-progress","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package does not provide an ESM export; CommonJS require is the correct method.","wrong":"import ProgressBar from 'progress';","symbol":"ProgressBar","correct":"const ProgressBar = require('progress');"},{"note":"Named import does not work because the module exports a single constructor function as default.","wrong":"import { ProgressBar } from 'progress';","symbol":"ProgressBar (ESM via import)","correct":"import ProgressBar from 'progress';\n// Requires Node >= 12 with 'type': 'module' or .mjs extension"},{"note":"TypeScript users must install @types/progress for type definitions.","wrong":"const ProgressBar: ...","symbol":"ProgressBar type (TypeScript)","correct":"import ProgressBar from 'progress';\n// No built-in types; use @types/progress"}],"quickstart":{"code":"const ProgressBar = require('progress');\nconst bar = new ProgressBar(':bar', { total: 10 });\nconst timer = setInterval(() => {\n  bar.tick();\n  if (bar.complete) {\n    console.log('\\ncomplete\\n');\n    clearInterval(timer);\n  }\n}, 100);","lang":"javascript","description":"Creates a progress bar with total 10 ticks, updates every 100ms until complete."},"warnings":[{"fix":"Use a more modern progress bar library or update to ember-cli-deploy-progress@1.3.0 (same engine range but Node 4+ works).","message":"Node engines >= 0.4.0 specified; no longer supported in modern Node. May cause deprecation warnings.","severity":"gotcha","affected_versions":">=0.4.0 <1.0.0"},{"fix":"If you rely on 'cursor', use this fork only. If you need compatibility with the original, remove 'cursor'.","message":"The 'cursor' option is added in this fork. It is not available in the original 'progress' package.","severity":"breaking","affected_versions":"*"},{"fix":"Pass `{ clear: true }` in options if you want the bar to be cleared upon completion.","message":"The library does not automatically clear the progress bar on completion; you must set 'clear: true' option.","severity":"gotcha","affected_versions":"*"},{"fix":"Ensure token names match exactly the placeholders in the format string.","message":"Custom tokens passed to tick() are not validated; misspelled tokens will be silently ignored.","severity":"gotcha","affected_versions":"*"},{"fix":"Keep the default unless you experience specific rendering problems.","message":"The 'renderThrottle' option default is 16ms. Changing it may cause performance issues or flickering.","severity":"deprecated","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install progress` (or `ember-cli-deploy-progress` if using the fork).","cause":"Package not installed or not available in node_modules","error":"Error: Cannot find module 'progress'"},{"fix":"Ensure you call `new ProgressBar(...)` and that `bar` is correctly assigned.","cause":"ProgressBar not properly instantiated or bar is undefined","error":"TypeError: bar.tick is not a function"},{"fix":"Add `const ProgressBar = require('progress');` at top of file.","cause":"ProgressBar variable not imported/required","error":"ReferenceError: ProgressBar is not defined"},{"fix":"Use default import: `import ProgressBar from 'progress'` (ESM) or `const ProgressBar = require('progress')` (CJS).","cause":"Importing wrong export (e.g., using named import)","error":"ProgressBar is not a constructor"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}