mirror of https://github.com/boa-dev/boa.git
HalidOdat
4 years ago
committed by
GitHub
13 changed files with 570 additions and 195 deletions
@ -0,0 +1,145 @@
|
||||
//! This module implements the `Attribute` struct which contains the attibutes for property descriptors.
|
||||
|
||||
use bitflags::bitflags; |
||||
use gc::{unsafe_empty_trace, Finalize, Trace}; |
||||
|
||||
#[cfg(test)] |
||||
mod tests; |
||||
|
||||
bitflags! { |
||||
/// This struct constains the property flags as describen in the ECMAScript specification.
|
||||
///
|
||||
/// It contains the following flags:
|
||||
/// - `[[Writable]]` (`WRITABLE`) - If `false`, attempts by ECMAScript code to change the property's `[[Value]]` attribute using `[[Set]]` will not succeed.
|
||||
/// - `[[Enumerable]]` (`ENUMERABLE`) - If the property will be enumerated by a for-in enumeration.
|
||||
/// - `[[Configurable]]` (`CONFIGURABLE`) - If `false`, attempts to delete the property, change the property to be an `accessor property`, or change its attributes (other than `[[Value]]`, or changing `[[Writable]]` to `false`) will fail.
|
||||
///
|
||||
/// Additionaly there are flags for when the flags are defined.
|
||||
#[derive(Finalize)] |
||||
pub struct Attribute: u8 { |
||||
/// None of the flags are present.
|
||||
const NONE = 0b0000_0000; |
||||
|
||||
/// The `Writable` attribute decides whether the value associated with the property can be changed or not, from its initial value.
|
||||
const WRITABLE = 0b0000_0011; |
||||
|
||||
/// The property is not writable.
|
||||
const READONLY = 0b0000_0010; |
||||
|
||||
/// Is the `Writable` flag defined.
|
||||
const HAS_WRITABLE = 0b0000_0010; |
||||
|
||||
/// If the property can be enumerated by a `for-in` loop.
|
||||
const ENUMERABLE = 0b0000_1100; |
||||
|
||||
/// The property can not be enumerated in a `for-in` loop.
|
||||
const NON_ENUMERABLE = 0b0000_1000; |
||||
|
||||
/// Is the `Enumerable` flag defined.
|
||||
const HAS_ENUMERABLE = 0b0000_1000; |
||||
|
||||
/// If the property descriptor can be changed later.
|
||||
const CONFIGURABLE = 0b0011_0000; |
||||
|
||||
/// The property descriptor cannot be changed.
|
||||
const PERMANENT = 0b0010_0000; |
||||
|
||||
/// Is the `Configurable` flag defined.
|
||||
const HAS_CONFIGURABLE = 0b0010_0000; |
||||
} |
||||
} |
||||
|
||||
// We implement `Trace` manualy rather that wih derive, beacuse `rust-gc`,
|
||||
// derive `Trace` does not allow `Copy` and `Trace` to be both implemented.
|
||||
//
|
||||
// SAFETY: The `Attribute` struct only contains an `u8`
|
||||
// and therefore it should be safe to implement an empty trace.
|
||||
unsafe impl Trace for Attribute { |
||||
unsafe_empty_trace!(); |
||||
} |
||||
|
||||
impl Attribute { |
||||
/// Clear all flags.
|
||||
#[inline] |
||||
pub fn clear(&mut self) { |
||||
self.bits = 0; |
||||
} |
||||
|
||||
/// Is the `writable` flag defined.
|
||||
#[inline] |
||||
pub fn has_writable(self) -> bool { |
||||
self.contains(Self::HAS_WRITABLE) |
||||
} |
||||
|
||||
/// Sets the `writable` flag.
|
||||
#[inline] |
||||
pub fn set_writable(&mut self, value: bool) { |
||||
if value { |
||||
*self |= Self::WRITABLE; |
||||
} else { |
||||
*self |= *self & !Self::WRITABLE; |
||||
} |
||||
} |
||||
|
||||
/// Gets the `writable` flag.
|
||||
#[inline] |
||||
pub fn writable(self) -> bool { |
||||
debug_assert!(self.has_writable()); |
||||
self.contains(Self::WRITABLE) |
||||
} |
||||
|
||||
/// Is the `enumerable` flag defined.
|
||||
#[inline] |
||||
pub fn has_enumerable(self) -> bool { |
||||
self.contains(Self::HAS_ENUMERABLE) |
||||
} |
||||
|
||||
/// Sets the `enumerable` flag.
|
||||
#[inline] |
||||
pub fn set_enumerable(&mut self, value: bool) { |
||||
if value { |
||||
*self |= Self::ENUMERABLE; |
||||
} else { |
||||
*self |= *self & !Self::ENUMERABLE; |
||||
} |
||||
} |
||||
|
||||
/// Gets the `enumerable` flag.
|
||||
#[inline] |
||||
pub fn enumerable(self) -> bool { |
||||
debug_assert!(self.has_enumerable()); |
||||
self.contains(Self::ENUMERABLE) |
||||
} |
||||
|
||||
/// Is the `configurable` flag defined.
|
||||
#[inline] |
||||
pub fn has_configurable(self) -> bool { |
||||
self.contains(Self::HAS_CONFIGURABLE) |
||||
} |
||||
|
||||
/// Sets the `configurable` flag.
|
||||
#[inline] |
||||
pub fn set_configurable(&mut self, value: bool) { |
||||
if value { |
||||
*self |= Self::CONFIGURABLE; |
||||
} else { |
||||
*self |= *self & !Self::CONFIGURABLE; |
||||
} |
||||
} |
||||
|
||||
/// Gets the `configurable` flag.
|
||||
#[inline] |
||||
pub fn configurable(self) -> bool { |
||||
debug_assert!(self.has_configurable()); |
||||
self.contains(Self::CONFIGURABLE) |
||||
} |
||||
} |
||||
|
||||
impl Default for Attribute { |
||||
/// Returns the default flags according to the [ECMAScript specification][spec].
|
||||
///
|
||||
/// [spec]: https://tc39.es/ecma262/#table-default-attribute-values
|
||||
fn default() -> Self { |
||||
Self::READONLY | Self::NON_ENUMERABLE | Self::PERMANENT |
||||
} |
||||
} |
||||
@ -0,0 +1,167 @@
|
||||
use super::Attribute; |
||||
|
||||
#[test] |
||||
fn writable() { |
||||
let attribute = Attribute::WRITABLE; |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(attribute.writable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn enumerable() { |
||||
let attribute = Attribute::ENUMERABLE; |
||||
|
||||
assert!(attribute.has_enumerable()); |
||||
assert!(attribute.enumerable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn configurable() { |
||||
let attribute = Attribute::CONFIGURABLE; |
||||
|
||||
assert!(attribute.has_configurable()); |
||||
assert!(attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn writable_and_enumerable() { |
||||
let attribute = Attribute::WRITABLE | Attribute::ENUMERABLE; |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(attribute.enumerable()); |
||||
|
||||
assert!(!attribute.has_configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn enumerable_configurable() { |
||||
let attribute = Attribute::ENUMERABLE | Attribute::CONFIGURABLE; |
||||
|
||||
assert!(!attribute.has_writable()); |
||||
|
||||
assert!(attribute.has_enumerable()); |
||||
assert!(attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn writable_enumerable_configurable() { |
||||
let attribute = Attribute::WRITABLE | Attribute::ENUMERABLE | Attribute::CONFIGURABLE; |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn default() { |
||||
let attribute = Attribute::default(); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn clear() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.clear(); |
||||
|
||||
assert!(!attribute.has_writable()); |
||||
assert!(!attribute.has_enumerable()); |
||||
assert!(!attribute.has_configurable()); |
||||
|
||||
assert!(attribute.is_empty()); |
||||
} |
||||
|
||||
#[test] |
||||
fn set_writable_to_true() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.set_writable(true); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(!attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(!attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn set_writable_to_false() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.set_writable(false); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(!attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(!attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(!attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn set_enumerable_to_true() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.set_enumerable(true); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(!attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(!attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn set_enumerable_to_false() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.set_enumerable(false); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(!attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(!attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(!attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn set_configurable_to_true() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.set_configurable(true); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(!attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(!attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(attribute.configurable()); |
||||
} |
||||
|
||||
#[test] |
||||
fn set_configurable_to_false() { |
||||
let mut attribute = Attribute::default(); |
||||
|
||||
attribute.set_configurable(false); |
||||
|
||||
assert!(attribute.has_writable()); |
||||
assert!(!attribute.writable()); |
||||
assert!(attribute.has_enumerable()); |
||||
assert!(!attribute.enumerable()); |
||||
assert!(attribute.has_configurable()); |
||||
assert!(!attribute.configurable()); |
||||
} |
||||
Loading…
Reference in new issue