تحت اللفظی

توضیحات

اسناد را از یک مجموعه ثابت از اشیاء سند از پیش تعریف شده برمی‌گرداند.

این مرحله معمولاً برای آزمایش سایر مراحل به صورت جداگانه استفاده می‌شود، اگرچه می‌تواند به عنوان ورودی برای اتصال شرایط نیز مورد استفاده قرار گیرد.

مثال‌ها

نود جی اس 

const results = await db.pipeline()
  .literals({ name: "joe", age: 10 }, { name: "bob", age: 30 }, { name: "alice", age: 40 })
  .where(field("age").lessThan(35))
  .execute();

رفتار

مرحله‌ی literals(...) فقط می‌تواند به عنوان اولین مرحله در یک خط لوله (یا زیرخط لوله) استفاده شود. ترتیب اسناد برگردانده شده از literals(...) با ترتیب تعریف آنها مطابقت دارد.

اگرچه مقادیر تحت‌اللفظی رایج‌ترین هستند، اما می‌توان عباراتی را نیز ارسال کرد که ارزیابی و بازگردانده می‌شوند و امکان آزمایش رفتار پرس‌وجو/عبارت مختلف را بدون نیاز به ایجاد داده‌های آزمایشی فراهم می‌کنند.

برای مثال، کد زیر نحوه‌ی آزمایش سریع تابع length(...) را روی برخی مجموعه‌های تست ثابت نشان می‌دهد:

نود جی اس 

const results = await db.pipeline()
  .literals({ x: constant("foo-bar-baz").length() }, { x: constant("bar").length() })
  .execute();

...

[
  { x: 11 },
  { x: 3 }
]