Ramda’s R.propSatisfies() answers a top-level validation question: does this property pass my predicate? You pass a predicate, a property name string, then the object. Ramda reads the value with R.prop, then calls your predicate. You get true or false. Native code would manually read obj[name] and test it. R.propSatisfies is a function, arity 3, automatically curried, so R.propSatisfies(R.gt(0), 'score') is already a function of one object.
The official sample is the whole idea. R.propSatisfies(x => x > 0, 'x', {x: 1, y: 2}) is true because 1 > 0. Need to read the value without a test? That is R.prop. Need a nested field? That is pathSatisfies. Need strict equality? That is propEq. Need multiple properties at once? That is R.where. Previous Logic helper is R.pathSatisfies. Next is R.unless.
Syntax
Call R.propSatisfies. Start with this line.
Ramda
R.propSatisfies(pred, name, obj)
Call
What it does
R.propSatisfies(pred, name, obj)
Primary signature.
R.propSatisfies(...)
Call the logic helper.
Prefer import { propSatisfies } from "ramda" when you want a named import.
Library declarations
Ramda
R.propSatisfies(pred, name, obj)
Parameters
Parameter
Description
pred
Required. Function. Predicate run on the property value from R.prop. Should return true or false.
name
Required. String. Top-level property name such as 'name', 'age', or 'score'.
obj
Required. Object. The record to query. Missing keys make R.prop return undefined.
Return Value
Return Value
Description
Boolean
true when the predicate passes on the property value. Otherwise false. The object is not mutated.
Ramda Examples
📚 Getting Started
The official Ramda predicate sample, then cousins pathSatisfies, propEq, propIs, and prop.
Example 1 — Official Predicate Samples
The docs show a top-level positive check plus false and missing-key cases. All return booleans from your predicate.
pathSatisfies with ['name'] matches one top-level key here, but use it for nested paths. prop returns the value without a boolean test. Previous Logic helper is R.pathSatisfies.
📈 Practical Patterns
Missing properties and undefined leftovers, then filter with curry, then prop and where for multiple keys.
Example 3 — Missing Property and undefined to Predicate
When a key is missing, R.prop returns undefined. Your predicate still runs and decides the boolean.
Because propSatisfies is arity 3, filling predicate and name leaves a function of one object. R.filter(hasStringName, rows) keeps rows whose name passes R.is(String).
Example 5 — vs prop and where
propSatisfies tests one key. prop reads the value. where checks multiple properties at once with a spec object.
where is the multi-key cousin. Use propSatisfies for one property test; use where when every key in the spec must pass. Next Logic helper is R.unless.
Compatibility
Browser Support
R.propSatisfies() is ordinary JavaScript once Ramda is loaded. Logos use the shared browser-image-sprite.png sprite from this project.
✓ Ramda 0.16.0+ · Any JS runtime
Ramda.js R.propSatisfies()
Load Ramda 0.16.0 or later via CDN or npm, then call R.propSatisfies with a predicate, property name, and object. No extra browser API is required.
100%With Ramda 0.16.0+
Google ChromeAll versions · Desktop & Mobile
Full support
Mozilla FirefoxAll versions · Desktop & Mobile
Full support
Apple SafariAll versions · macOS & iOS
Full support
Microsoft EdgeAll versions · Chromium & Legacy
Full support
Internet ExplorerIE 6+ · Legacy environments
Full support
OperaAll modern versions
Full support
R.propSatisfies()Universal
Bottom line: Safe in any project that includes Ramda 0.16.0 or later. Use a CDN build such as ramda.min.js in the browser or install ramda from npm for Node. These labs use [email protected].
Frequently Asked Questions
R.propSatisfies(pred, name, obj) reads the top-level property with R.prop, then returns pred(value). true when the predicate passes, false otherwise. Added in v0.16.0. Type: (a → Boolean) → String → {String: a} → Boolean. Arity 3, curried.
R.propSatisfies(x => x > 0, 'x', {x: 1, y: 2}) is true because 1 > 0. The predicate runs on the value at the named top-level key.
pathSatisfies tests a nested path. propEq checks strict equality to a fixed value. propIs checks a constructor type. prop reads the value without a test. propSatisfies runs any predicate on one top-level key.
R.prop returns undefined for a missing key. The predicate still runs. For example, (x => x > 0)(undefined) is false. You get false, not a throw.
propSatisfies names the pattern, is curried for filter and pipe, and handles the property read in one helper. R.filter(R.propSatisfies(pred, 'name')) keeps rows that pass.
No. R.propSatisfies is a stable Ramda logic helper from v0.16.0. It is not deprecated, experimental, or non-standard.