dphelper/docs/markdown/memory.md

dphelper devtools for developers

# memory

Memory and state management.

## Functions

| Function | Description | Example |
|----------|-------------|---------|
| `lock` | Lock a state property | `dphelper.memory.lock('state[key]')` |
| `unlock` | Unlock a state property | `dphelper.memory.unlock('state[key]')` |

## Description

State property protection:
- **Lock** - Make property non-writable and non-configurable
- **Unlock** - Restore writability and configurability
- **Global State** - Work with window-level state objects

## Usage Examples

### Lock State Property

```javascript
// Define global state
window.myApp = {
  config: { theme: 'dark' },
  user: { name: 'John' }
};

// Lock the config
dphelper.memory.lock('myApp.config');

// Try to modify (will fail silently or throw in strict mode)
myApp.config = {}; // Won't work - locked

// Can still modify properties if not locked
myApp.config.theme = 'light'; // May work depending on implementation
```

### Unlock State Property

```javascript
// Unlock previously locked property
dphelper.memory.unlock('myApp.config');

// Now can modify
myApp.config = { theme: 'light' };
```

### Protect Application State

```javascript
// Create protected app state
const appState = {
  version: '1.0.0',
  initialized: false,
  data: {}
};

// Add to window
window.appState = appState;

// Lock critical properties
dphelper.memory.lock('appState.version'); // Prevent version changes
dphelper.memory.lock('appState.initialized'); // Prevent re-initialization

// Unlock when needed (e.g., updates)
function updateVersion(newVersion) {
  dphelper.memory.unlock('appState.version');
  appState.version = newVersion;
  dphelper.memory.lock('appState.version');
}
```

## Details

- **Author:** Dario Passariello
- **Version:** 0.0.2
- **Creation Date:** 20230101
- **Last Modified:** 20230111
- **Environment:** client (browser)

---

*Automatically generated document*