{"id":43161,"library":"mongodb-memory-server-global-4.2","title":"mongodb-memory-server Global (MongoDB 4.2)","description":"A sub-package of mongodb-memory-server that automatically downloads a MongoDB 4.2 binary for testing purposes. Version 11.2.0 is current; releases follow mongodb-memory-server core with weekly or monthly cadence. It eliminates the need to manually manage mongod binaries for CI/CD and local test environments. Unlike mongodb-memory-server-core, this package includes the binary download as a postinstall step, making setup effortless. Supports TypeScript with bundled type declarations. Requires Node >=20.19.0 and is ESM-only since v9+. Key differentiator: pre-pinned version (4.2) avoiding version drift in tests.","status":"active","version":"11.2.0","language":"javascript","source_language":"en","source_url":"https://github.com/typegoose/mongodb-memory-server","tags":["javascript","mongodb","mongoose","mock","stub","mockgoose","mongodb-prebuilt","mongomem","typescript"],"install":[{"cmd":"npm install mongodb-memory-server-global-4.2","lang":"bash","label":"npm"},{"cmd":"yarn add mongodb-memory-server-global-4.2","lang":"bash","label":"yarn"},{"cmd":"pnpm add mongodb-memory-server-global-4.2","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Provides the core logic for starting/stopping in-memory MongoDB instances.","package":"mongodb-memory-server-core","optional":false},{"reason":"The actual mongod binary is downloaded during core's postinstall step.","package":"mongodb-memory-server-core","optional":false}],"imports":[{"note":"ESM-only since v9; CommonJS require will fail. Use default import if you must use require.","wrong":"const { MongoMemoryServer } = require('mongodb-memory-server-core')","symbol":"MongoMemoryServer","correct":"import { MongoMemoryServer } from 'mongodb-memory-server-core'"},{"note":"Default import is deprecated since v8; use named import instead.","wrong":"const MongoMemoryServer = require('mongodb-memory-server-core')","symbol":"MongoMemoryServer (default)","correct":"import MongoMemoryServer from 'mongodb-memory-server-core'"},{"note":"Also ESM-only. Ensure tsconfig has 'moduleResolution': 'node16' or 'bundler'.","wrong":"","symbol":"MongoMemoryReplSet","correct":"import { MongoMemoryReplSet } from 'mongodb-memory-server-core'"}],"quickstart":{"code":"import { MongoMemoryServer } from 'mongodb-memory-server-core';\n\nconst mongod = await MongoMemoryServer.create();\nconst uri = mongod.getUri();\nconsole.log('MongoDB URI:', uri);\n\nconst db = await mongod.getDbName();\nconsole.log('DB name:', db);\n\n// Use uri to connect with mongoose or mongodb driver\nawait mongod.stop();","lang":"typescript","description":"Creates an in-memory MongoDB 4.2 instance, outputs connection URI, and stops it."},"warnings":[{"fix":"Use named import: import { MongoMemoryServer } from 'mongodb-memory-server-core'","message":"Default import of MongoMemoryServer was removed in v9.","severity":"breaking","affected_versions":">=9.0.0"},{"fix":"Pass options as argument: await MongoMemoryServer.create({ instance: { port: 27017 } })","message":"async create() no longer accepts instance options; use create(options) instead.","severity":"breaking","affected_versions":">=9.0.0"},{"fix":"Access mongod.uri instead of mongod.getUri() and mongod.dbName instead of mongod.getDbName()","message":"getUri() and getDbName() are deprecated; use uri and dbName properties after instance creation.","severity":"deprecated","affected_versions":">=10.0.0"},{"fix":"Use await MongoMemoryServer.create() instead of new MongoMemoryServer()","message":"MongoMemoryServer no longer accepts new keyword; use create() static method.","severity":"breaking","affected_versions":">=9.0.0"},{"fix":"Set HTTP_PROXY/HTTPS_PROXY environment variables or pre-download binary and set MONGOMS_SYSTEM_BINARY.","message":"Binary download may fail behind corporate proxies or in restrictive CI environments.","severity":"gotcha","affected_versions":">=0"},{"fix":"Upgrade Node.js to version 20.19.0 or later.","message":"Node.js >=20.19.0 required; older versions will not work.","severity":"breaking","affected_versions":">=11.0.0"},{"fix":"Remove these options; they are no longer needed.","message":"allowUseCmd and useCmd options are deprecated.","severity":"deprecated","affected_versions":">=10.0.0"}],"env_vars":null,"search_vec":"'11.2.0':28 '20.19.0':85 '4.2':7,22,99 'automat':18 'avoid':100 'binari':23,51,68 'bundl':80 'cadenc':42 'ci/cd':53 'core':37,63 'current':30 'declar':82 'differenti':94 'download':19,69 'drift':102 'effortless':76 'elimin':44 'environ':57 'esm':89 'esm-on':88 'follow':32 'global':5 'includ':66 'javascript':105 'key':93 'local':55 'make':74 'manag':49 'manual':48 'memori':3,15,35,61 'mock':108 'mockgoos':110 'mongod':50 'mongodb':2,6,14,21,34,60,106,112 'mongodb-memory-serv':1,13,33 'mongodb-memory-server-cor':59 'mongodb-prebuilt':111 'mongomem':114 'mongoos':107 'month':41 'need':46 'node':84 'packag':11,65 'pin':97 'postinstal':72 'pre':96 'pre-pin':95 'prebuilt':113 'purpos':26 'releas':31 'requir':83 'server':4,16,36,62 'setup':75 'sinc':91 'step':73 'stub':109 'sub':10 'sub-packag':9 'support':77 'test':25,56,104 'type':81 'typescript':78,115 'unlik':58 'v9':92 'version':27,98,101 'week':39","created_at":"2026-06-05T16:58:28.604580+00:00","updated_at":"2026-06-05T16:58:28.604580+00:00","problems":[{"fix":"Install mongodb-memory-server-core: npm install mongodb-memory-server-core","cause":"Missing peer dependency mongodb-memory-server-core or incorrect import from subpackage.","error":"Error: Cannot find module 'mongodb-memory-server-core'"},{"fix":"Use mongod.uri property instead.","cause":"Using deprecated getUri() in version 10+ where it was removed.","error":"TypeError: mongod.getUri is not a function"},{"fix":"Switch to ESM import (import { MongoMemoryServer } from 'mongodb-memory-server-core') or set type: module in package.json.","cause":"Using CommonJS require() with version 9+.","error":"Error: This module is ESM-only. To use it, you must use ESM imports or dynamic imports."},{"fix":"Check internet connection, set proxy variables, or use MONGOMS_SYSTEM_BINARY to point to a pre-installed binary.","cause":"Network issue or missing system dependencies (like libcurl).","error":"Error: Failed to download mongod binary version 4.2.0"},{"fix":"Use import { MongoMemoryServer } from 'mongodb-memory-server-core'","cause":"Using default import instead of named import in v9+.","error":"TypeError: (intermediate value).create is not a constructor"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/typegoose/mongodb-memory-server","github":"https://github.com/typegoose/mongodb-memory-server","docs":null,"changelog":null,"pypi":null,"npm":"mongodb-memory-server-global-4.2","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-05","next_check":"2026-09-03","install_tag":null}}