NodeShell

NodeShell enables you to execute JavaScript code for direct data manipulation within Mingo. This is not the MongoDB Shell — it is a custom JavaScript execution environment.

Usage

The command must be structured as a regular async JavaScript function with a return value. This enables sophisticated operations including loops, conditions, and variable initialization.

Example: Basic Query

async function () {
  return await MyCollection.find({})
}

Example: Batch Update

async function () {
  const docs = await Users.find({ status: "pending" }).toArray()
  for (const doc of docs) {
    await Users.updateOne(
      { _id: doc._id },
      { $set: { status: "active" } }
    )
  }
  return `Updated ${docs.length} documents`
}

Example: Complex Workflow

async function () {
  const confirmed = await MingoConfirm("Run migration?")
  if (!confirmed) return "Cancelled"

  const source = await Orders.find({ migrated: { $ne: true } }).toArray()
  let count = 0
  for (const doc of source) {
    await ArchivedOrders.insertOne(doc)
    await Orders.updateOne({ _id: doc._id }, { $set: { migrated: true } })
    count++
  }
  return `Migrated ${count} orders`
}

Available Variables

• db — current MongoDB database connection
• Collection names — direct references (e.g. Amenities equals db.collection("Amenities"))
• ObjectId — MongoDB ObjectId wrapper
• dayjs — date manipulation library
• _ (underscore) — Lodash utility library
• MingoConfirm() — show a confirmation modal
• MingoAlert() — show an alert modal
• MingoPrompt() — show a prompt modal
• console.log(), console.warn(), console.error() — debugging output

History

NodeShell maintains a complete log of previously executed functions with fulltext search capabilities for retrieval.

Code Storage

You can save code snippets and examples, organized by individual database for convenient reuse.